bluebubbles

Send and manage iMessages through the BlueBubbles gateway message tool.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/srgaba/open-claw --skill bluebubbles-srgaba
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/srgaba/open-claw/tree/main/project/skills/bluebubbles
Command: npx skills add https://github.com/srgaba/open-claw --skill bluebubbles-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you send and manage iMessages programmatically through BlueBubbles, OpenClaw's recommended iMessage integration, without manually operating the Messages app. ## Core Features & Use Cases - Message Sending: Send texts, attachments, and messages with iMessage effects to phone numbers, emails, or chat GUIDs. - Conversation Management: React with tapbacks, edit or unsend messages, and reply in threads using message IDs. - Use Case: A user asks to text a photo to a family member; the Skill sends the attachment with a caption via the BlueBubbles channel using the recipient's chat GUID. ## Quick Start Ask the assistant to send an iMessage saying hello to +15551234567 through the BlueBubbles channel.

Frequently Asked Questions about bluebubbles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an iMessage with BlueBubbles?▼

Send an iMessage by calling the message tool with action send, channel bluebubbles, a target such as a chat_guid or E.164 phone number, and the message text. The request routes through the BlueBubbles gateway.

How do I react to an iMessage with a tapback?▼

Use the react action with the target chat, the messageId of the message, and an emoji such as a heart. Set remove to true on the same call to remove an existing reaction.

Can I edit or unsend iMessages through BlueBubbles?▼

Yes, the edit and unsend actions work with a target and messageId. Note that some actions are macOS-version dependent; for example, edit may be broken on macOS 26 Tahoe.

What configuration does the BlueBubbles channel require?▼

The gateway requires the channels.bluebubbles config with serverUrl, password, and webhookPath. Without this configuration, message calls through the bluebubbles channel will not work.

Should I use chat_guid or phone number as the message target?▼

Prefer chat_guid targets when available, especially for group chats, since they are more precise. Phone numbers in E.164 format and email addresses also work for direct conversations.