bluebubbles

Route iMessage traffic through BlueBubbles with the generic message tool.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/MaxSaiets/myOpenCL --skill bluebubbles-maxsaiets
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/MaxSaiets/myOpenCL/tree/main/openclaw/skills/bluebubbles
Command: npx skills add https://github.com/MaxSaiets/myOpenCL --skill bluebubbles-maxsaiets

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates sending and managing iMessages through BlueBubbles by routing through the generic message tool with channel set to bluebubbles, simplifying cross-app messaging workflows.

Core Features & Use Cases

  • Use the generic message tool with channel="bluebubbles" to send texts and manage iMessages.
  • Support reactions (tapbacks), edits, unsend, and in-thread replies.
  • Manage group chats, including participant lists, names, and icons within conversations.

Quick Start

Send a message to a chat 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 through a custom gateway?

To send iMessages through a custom gateway, use the generic message tool with the channel set to bluebubbles. This routes your text and attachments to one-to-one or group chats via a configured BlueBubbles gateway.

Can I manage iMessage reactions, edits, and unsend requests via an API?

Yes, you can manage iMessage reactions, edits, and unsend requests via the message tool. By routing through the bluebubbles channel, you can execute tapbacks, modify messages, and delete sent texts.

How do I automate group chat participant management for iMessage?

Automate group chat participant management for iMessage by invoking the message tool with the bluebubbles channel. This supports updating participant lists, changing group names, and modifying icons within conversations.

Do I need a configured BlueBubbles server to send iMessages programmatically?

Yes, you need a configured BlueBubbles gateway set up as channels.bluebubbles to send iMessages programmatically. The tool relies on this connection and standard message payload fields like target and message to operate.

What is required to reply to a specific iMessage in a thread?

To reply to a specific iMessage in a thread, you need the standard message payload fields including the target messageId. Routing the request through the bluebubbles channel enables in-thread replies for both groups and individuals.