skills.rest
RobbyMo81
RobbyMo81COMMUNITY
Explore all skills by this author →
GitHub

bluebubbles

Send and manage iMessages and attachments via a BlueBubbles gateway.

Updated Feb 16, 2026
Search Tags:#messaging#attachments#imessage#reactions#bluebubbles#chat_guid
One-click install
npx skills add https://github.com/RobbyMo81/assistantrobby --skill bluebubbles-robbymo81
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/RobbyMo81/assistantrobby/tree/main/skills/bluebubbles
Command: npx skills add https://github.com/RobbyMo81/assistantrobby --skill bluebubbles-robbymo81

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable sending and managing iMessage conversations through a BlueBubbles gateway so users can control messages, reactions, edits, unsends, replies, and attachments from the assistant without direct access to an Apple device.

Core Features & Use Cases

  • Send and Reply: Send plain text messages, reply to specific messages or threads, and edit previously sent messages when supported.
  • Reactions and Management: Apply or remove tapback reactions, unsend messages, and manage group participants, names, and icons using chat_guids for reliability.
  • Attachments and Effects: Send local files by path or base64 buffers with filenames, include captions, and apply iMessage effects like balloons where supported.
  • Operational Notes: Actions are executed via the generic message tool with channel set to "bluebubbles" and require gateway configuration for channels.bluebubbles.

Quick Start

Send a message "hello from OpenClaw" to +15551234567 by using the message tool with channel set to bluebubbles.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I send iMessages from an assistant without direct access to an Apple device?▼

You can send iMessages by routing requests through a BlueBubbles gateway, allowing the assistant to trigger text messages, replies, and edits on your behalf without needing a Mac or iPhone present.

Can I manage iMessage group chats and tapback reactions via a messaging API?▼

Yes, managing iMessage group chats is supported. You can apply or remove tapback reactions, unsend messages, and update group names using durable chat_guid identifiers for reliable targeting.

How do I send file attachments in iMessage through a gateway connection?▼

To send file attachments in iMessage, you provide a local file path or base64 buffer with a filename, optionally include a caption, and the gateway transmits the payload to the specified chat.

Do I need a specific gateway configuration to use iMessage automation features?▼

Yes, iMessage automation requires a configured BlueBubbles gateway. You must set up the channels.bluebubbles connection to route message tool actions and execute commands like sending texts and reactions.

Can I reply to specific iMessage threads and apply visual effects like balloons?▼

Yes, you can reply directly within specific iMessage threads and apply visual effects like balloons where supported, executing these actions via the generic message tool with the channel parameter set to bluebubbles.

Related Skills

Explore More Software Engineering Skills→
dvdsgldvdsgl
54

imessage

Read and send iMessages via sqlite3 and AppleScript on macOS.

Community
Advanced
PolealphaPolealpha

bluebubbles

Send iMessages, reply in threads, and manage conversation actions via BlueBubbles.

Community
Intermediate
BEIRUXBEIRUX

bluebubbles

Send and manage iMessage conversations and attachments via the BlueBubbles gateway.

Official
Intermediate
linuxhsjlinuxhsj
5.1k

bluebubbles

Send and manage iMessages through the BlueBubbles gateway.

Community
Intermediate