skills.rest
BEIRUX
BEIRUXOFFICIAL
Explore all skills by this author →
GitHub

bluebubbles

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

Updated Apr 3, 2026
Search Tags:#messaging#chat#imessage#send#attachment#bluebubbles#reaction
One-click install
npx skills add https://github.com/BEIRUX/agent-skills --skill bluebubbles-beirux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/BEIRUX/agent-skills/tree/main/bluebubbles
Command: npx skills add https://github.com/BEIRUX/agent-skills --skill bluebubbles-beirux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

BlueBubbles Actions lets agents send and manage iMessage conversations programmatically when native iMessage access is required, removing the friction of manual messaging across devices and enabling attachments, reactions, edits, and group management via a gateway.

Core Features & Use Cases

  • Send and Reply: Send messages, reply in-thread, and address recipients by chat_guid, E.164 phone number, or email handle.
  • Message Management: Edit or unsend messages and add or remove tapback reactions to acknowledge or modify prior content.
  • Attachments & Effects: Send files via local path or base64 buffers with captions and apply iMessage effects like balloons.
  • Group Operations: Manage group participants, names, and icons; prefer chat_guid for durable targeting.
  • Use Case: Automate customer notifications, upload photos to a thread, react to incoming messages, or programmatically correct previously sent text.

Quick Start

Send a message saying "Hello from OpenClaw" 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 automate sending iMessage texts programmatically?▼

Automate sending iMessage texts by routing requests through a configured BlueBubbles gateway. Address recipients using chat_guid, E.164 phone numbers, or email handles to send messages, replies, and attachments.

Can I send files and photos in iMessage via an API?▼

Send files and photos in iMessage by passing local file paths or base64 buffers to the BlueBubbles gateway. Attachments can include captions and support iMessage effects like balloons.

How do I programmatically edit, unsend, or react to iMessages?▼

Programmatically edit, unsend, or react to iMessages using gateway actions. Add or remove tapback reactions to acknowledge content, or correct previously sent text without manual device interaction.

What do I need to set up before managing group chats via BlueBubbles?▼

Managing group chats via BlueBubbles requires a configured gateway connection. Prefer using the durable chat_guid identifier to manage group participants, names, and icons accurately.

Does BlueBubbles support automating customer notifications through iMessage?▼

BlueBubbles supports automating customer notifications through iMessage. It handles one-to-one and group chat operations, enabling automated message delivery and attachment sharing.

What is the best way to target a specific iMessage thread programmatically?▼

The best way to target a specific iMessage thread is using the chat_guid identifier. This durable target ensures message routing accuracy compared to phone numbers or email handles.

Related Skills

Explore More Software Engineering Skills→
me2Docme2Doc
6

bluebubbles

Manage iMessage interactions through the BlueBubbles gateway API.

Community
Intermediate
Greenmamba29Greenmamba29

webhook-orchestrator

Routes, transforms, and fans out webhook payloads to multiple services.

Community
Advanced
wangqianCAIwangqianCAI

imsg

Send SMS or iMessage texts and read macOS Messages.app conversation history.

Community
Intermediate
syxscottsyxscott
1

bluebubbles

Manage iMessage conversations via BlueBubbles with send, react, edit, and unsend actions.

Community
Intermediate