skills.rest
travis-burmaster
travis-burmasterCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

bluebubbles

Send and manage iMessages through the BlueBubbles gateway message tool.

Updated Feb 16, 2026
Search Tags:#messaging#chat#attachments#imessage#bluebubbles#send message#tapback
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill bluebubbles-travis-burmaster
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/bluebubbles
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill bluebubbles-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing iMessage conversations programmatically requires a bridge to Apple's messaging ecosystem, and this Skill provides structured actions for sending texts, attachments, reactions, edits, and group management through the BlueBubbles server integration. ## Core Features & Use Cases - Message Sending: Send text messages, attachments with captions, and messages with iMessage effects like balloons to phone numbers, emails, or chat GUIDs. - Message Management: React with tapbacks, edit sent messages, unsend messages, and reply in threads using message IDs. - Use Case: A user asks the agent to text a colleague a project update with an attached screenshot; the agent uses the sendAttachment action with the recipient's chat GUID and the local file path. ## Quick Start Ask the agent to 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 a phone number in E.164 format or chat GUID, and the message text. The request routes through the configured BlueBubbles gateway.

How do I react to an iMessage with a tapback?▼

Use the react action with the target chat, the messageId of the message, and an emoji such as a heart. Setting remove to true on the same call removes the reaction.

Can I edit or unsend iMessages with BlueBubbles?▼

Yes, the edit and unsend actions work with a target and messageId. Note that some actions are macOS-version dependent; for example, edit may be broken on macOS 26 Tahoe.

What configuration does the BlueBubbles integration require?▼

The gateway requires channels.bluebubbles configuration including serverUrl, password, and webhookPath. Without this config, message actions through the bluebubbles channel will not work.

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 and email addresses also work for direct conversations.

Related Skills

Explore More Content & Communication Skills→
SeanHoggSeanHogg
3

bluebubbles

Send and manage iMessages through the BlueBubbles integration.

Community
Intermediate
aura-farmingaura-farming
3

reply-handling

Classify sales reply messages and route follow-up actions in CRM systems.

Community
Advanced
swcstudiospaceswcstudiospace

imessage

Send and read iMessage and SMS messages via the imsg CLI on macOS.

Official
Basic
lemonlqflemonlqf

bluebubbles

Send and manage iMessages with attachments and effects via BlueBubbles.

Community
Intermediate