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.