bluebubbles

Send, edit, react to, and manage iMessage conversations via BlueBubbles.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill bluebubbles-johnnywhitemike
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/JOHNNYWHITEMIKE/openclaw/tree/main/openclaw/.openclaw/openclaw/skills/bluebubbles
Command: npx skills add https://github.com/JOHNNYWHITEMIKE/openclaw --skill bluebubbles-johnnywhitemike

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It streamlines sending, editing, and managing iMessages through the BlueBubbles gateway instead of manually working inside chat apps.

Core Features & Use Cases

  • Message send & follow-ups: Send new texts, reply to specific messages in threads, and manage delivery context for direct chats or groups.
  • Rich interaction controls: React (tapbacks), remove reactions, edit previously sent messages, and unsend messages.
  • Attachments & effects: Send local file attachments and trigger iMessage effects for a more expressive delivery.
  • Use Case: You need to acknowledge a request, follow up in the same conversation thread, and share a photo with a caption—without switching tools.

Quick Start

Use the bluebubbles skill to send a message to a chat by telling it the recipient (for example +15551234567) and the exact text you want to send.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I automate sending iMessages through a gateway API?

You can automate sending iMessages by specifying a target handle or chat_guid, the message text, and using channel="bluebubbles" to route the payload through the BlueBubbles gateway.

Can I send threaded replies and tapbacks to specific iMessage texts?

Yes, threaded replies and tapbacks are supported by referencing a specific messageId in your payload, allowing you to react to or reply directly to targeted messages in a conversation.

How do I edit or unsend an iMessage programmatically?

To edit or unsend an iMessage, provide the specific messageId of the target text along with the corresponding action-specific payload to trigger the update or removal via the gateway.

How do I attach files to an iMessage using an automation script?

You can attach local files to an iMessage by including the attachment path or a buffer with a filename in your action-specific payload before sending it to the target handle.

Do I need a specific chat identifier to manage group iMessages?

Yes, managing group chat participant coordination requires a valid chat_guid or target handle to correctly route your message actions and attachments to the intended conversation thread.