Skip to content
TakoAPI
Back to skills

bluebubbles

by kevin19830331

Clawdbot Tools
6.8kDownloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Build or update the BlueBubbles external channel plugin.

Description

What This Skill Does

A Clawdbot extension package that connects the bot to a self-hosted BlueBubbles server for sending and receiving iMessages. Covers REST message delivery, webhook ingestion, tapback reactions, typing indicators, read receipts, and attachment handling.

Lets Clawdbot participate in iMessage threads without native Apple infrastructure by delegating to a user-controlled BlueBubbles server.

When to Use It

  • Routing iMessage conversations into a Clawdbot reply pipeline
  • Sending automated text replies to iMessages via a Mac-hosted BlueBubbles server
  • Forwarding inbound iMessage attachments and stickers to the bot for processing
  • Sending tapback reactions to specific iMessages by phone number and message ID
  • Health-checking a BlueBubbles server before enabling the channel

Example Workflow

INPUT

User sends an iMessage with a photo to a number handled by the bot

AGENT
  1. 1

    BlueBubbles posts a webhook JSON payload to the registered webhookPath on the gateway

  2. 2

    monitor.ts normalizes sender and chat IDs from the payload

  3. 3

    Attachment is downloaded via downloadBlueBubblesAttachment and referenced as a <media:...> placeholder

  4. 4

    Inbound context is routed into the core reply pipeline through the plugin runtime

  5. 5

    Bot processes the message and calls sendMessageBlueBubbles to deliver a reply

OUTPUT

Bot reply is delivered to the iMessage thread via the BlueBubbles REST API

Requirements

  • BlueBubbles server installed and running on a Mac (self-hosted)
  • channels.bluebubbles.serverUrl — base URL of the BlueBubbles server
  • channels.bluebubbles.password — password configured in the BlueBubbles server
  • channels.bluebubbles.webhookPath — path registered for inbound webhook delivery

Installation

clawhub install kevin19830331/bluebubbles

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links