Skip to content
Get packs

BlueBubbles iMessage Actions

Send, react to, edit, unsend and reply to iMessages through a BlueBubbles server

Source Download skill
Repository
spinabot/brigade
Stars
11,367
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent how to send and manage iMessages through BlueBubbles, a third-party bridge that connects to a Mac running iMessage. Once installed, the agent can send texts and attachments, add or remove tapback reactions, edit or unsend sent messages, reply to specific messages, and send messages with iMessage effects. It also tells the agent to ask for a recipient and exact message text when a request is vague, so it does not guess who to text.

Great for

  • People who already run a BlueBubbles server and want an agent to handle iMessage conversations
  • Developers building an agent on Brigade who need iMessage actions
  • Users who want an assistant to send quick texts or tapbacks on their behalf

Skip it if

  • Anyone without a Mac running iMessage and a BlueBubbles server, since the skill cannot work without that setup
  • Sending sensitive or irreversible messages unattended, because the agent may send to the wrong contact and unsend or edit depends on macOS version
  • Users who expect guaranteed attachment captions, since the skill itself warns that text with media may arrive as separate messages

Try asking

  • “Text my partner at +15551234567 that I'm running 10 minutes late”
  • “React with a heart to the last message in my chat with Sam”
  • “Reply to the message about Friday's dinner saying I can make it”
  • “Send this photo at /tmp/photo.jpg to the group chat with the note 'here you go'”
Step-by-step guide: how to use BlueBubbles iMessage ActionsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    bluebubbles.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip bluebubbles.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip bluebubbles.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent a chat_guid or full phone number in E.164 format to avoid sending to the wrong recipient
  • Check macOS version before relying on edit or unsend, since some actions may be broken on newer releases like macOS 26 Tahoe
  • Put the important words in the message text itself rather than relying on attachment captions

What's inside

  • SKILL.md

Redistributed unmodified from spinabot/brigade under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.