bluebubbles

Send and manage iMessages through the BlueBubbles gateway message tool.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill bluebubbles-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/bluebubbles
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill bluebubbles-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you send and manage iMessages programmatically through BlueBubbles, covering actions like texting, attachments, tapbacks, edits, and threaded replies without touching the Messages app manually. ## Core Features & Use Cases - Message Sending: Send texts, attachments with captions, and messages with iMessage effects like balloons via the message tool with channel "bluebubbles". - Conversation Management: React with tapbacks, edit or unsend sent messages, reply in threads, and target chats by phone number, email, or chat_guid. - Use Case: A user asks to text a photo to a family member; the skill sends the local image file as an attachment with a caption to the recipient's E.164 number through the BlueBubbles gateway. ## Quick Start Send an iMessage saying hello to +15551234567 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 an E.164 phone number or chat_guid, and the message text. The request routes through the BlueBubbles gateway to deliver the iMessage.

How do I send a photo attachment over iMessage?

Use the sendAttachment action with the target, a local file path, and an optional caption. You can also provide a base64 buffer with a filename instead of a path.

Can I edit or unsend an iMessage after sending it?

Yes, use the edit action with the messageId and new text, or the unsend action with just the messageId. Note that some actions like edit may be broken on certain macOS versions such as macOS 26 Tahoe.

What configuration does BlueBubbles require?

The gateway needs the channels.bluebubbles config with serverUrl, password, and webhookPath. Without this configuration, message requests through the bluebubbles channel will not work.

Should I use chat_guid or a phone number as the target?

Prefer chat_guid when available, especially for group chats, since it identifies conversations unambiguously. Phone numbers in E.164 format or email addresses also work for direct conversations.