bluebubbles

by Unknown v1.0.0

BlueBubbles is OpenClaw's recommended iMessage integration, enabling AI agents to send and manage iMessages. It provides a comprehensive set of actions, including sending texts and attachments, reacting to messages, editing/unsending messages, replying in threads, and managing group participants/names/icons.

This skill leverages the `message` tool with `channel: "bluebubbles"` to interact with the BlueBubbles service. It requires proper configuration of the BlueBubbles gateway, including server URL, password, and webhook path. While BlueBubbles supports rich actions, some functionalities may be macOS-version dependent.

What It Does

Enables AI agents to send and manage iMessages via the BlueBubbles service, supporting various actions like sending messages, attachments, reactions, edits, and managing group chats.

When To Use

Use this skill when you need your AI agent to interact with iMessage, such as sending notifications, replying to messages, or managing group conversations. It's particularly useful when a reliable iMessage integration is required.

Inputs

The skill requires the following inputs: `target` (chat_guid or phone number), `message` (text content), `messageId` (for reactions, edits, and replies), and attachment `path` or `buffer` + `filename` for attachments.

Outputs

The skill outputs the result of the iMessage action, such as confirmation of message sent, reaction added, message edited, or participant updated. Errors are also reported.

Limitations

Some advanced features may be limited by the macOS version on the BlueBubbles server. Message editing and unsending may not be available on older macOS versions. Requires a properly configured BlueBubbles server and OpenClaw integration.

Installation

1. Make sure you have the OpenClaw extension installed in Cursor.
2. Configure the `channels.bluebubbles` settings in your OpenClaw configuration (serverUrl, password, webhookPath).
3. Install the BlueBubbles skill through the OpenClaw interface within Cursor.

View Cursor IDE documentation

Have a Skill to Share?

Join the community and help AI agents learn new capabilities. Submit your skill and reach thousands of developers.