bluebubbles

Sends and manages iMessages through the BlueBubbles gateway message tool.

1|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill bluebubbles-solizardking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/Solizardking/Solana-Robotics-Kit/tree/main/eliza/packages/skills/skills/bluebubbles
Command: npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill bluebubbles-solizardking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets an AI agent send and manage iMessages on your behalf through BlueBubbles, covering texts, attachments, tapback reactions, edits, unsends, threaded replies, and group chat management without manual phone interaction. ## Core Features & Use Cases - Send and manage messages: Send texts, attachments with captions, and messages with iMessage effects like balloons via the generic message tool with channel="bluebubbles". - Reactions and edits: Add or remove tapback reactions, edit previously sent messages, unsend messages, and reply to specific messages in a thread. - Use Case: A user says "text my mom that I'll be late" — the agent collects the recipient handle or chat_guid and message content, then sends the iMessage through the configured BlueBubbles gateway. ## Quick Start Ask the agent to send an iMessage to a phone number or chat guid with your exact message text using 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?

Use 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 configured BlueBubbles gateway.

How do I react with a tapback on iMessage?

Call the message tool with action react, 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 BlueBubbles edit or unsend sent iMessages?

Yes, the edit and unsend actions modify or retract previously sent messages using their messageId. Note that edit may be broken on macOS 26 Tahoe, so behavior depends on the host macOS version.

What configuration does the BlueBubbles channel require?

The gateway needs channels.bluebubbles configured with serverUrl, password, and webhookPath. Without this configuration the skill cannot route any iMessage actions.

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 or email handles also work for direct conversations.