{
  "markdown": "# BlueBubbles Channel for Claude Code\n\nAn iMessage channel plugin for Claude Code using [BlueBubbles](https://bluebubbles.app/) as the bridge. Send and receive iMessages from a running Claude Code session.\n\n## Prerequisites\n\n- [Bun](https://bun.sh)\n- [BlueBubbles Server](https://bluebubbles.app/) running on a Mac with iMessage\n\n## Setup\n\n1. Clone this repo:\n\n   ```bash\n   git clone https://github.com/dmd/claudecode-channels-bluebubbles.git\n   cd claudecode-channels-bluebubbles\n   ```\n\n2. Create a `.env` file with your BlueBubbles credentials:\n\n   ```\n   BLUEBUBBLE_PASS=your-server-password\n   BLUEBUBBLE_HOST=your-server-name\n   BLUEBUBBLE_PORT=1234\n   BLUEBUBBLE_CONVERSATION=15551234567\n   ```\n\n   `BLUEBUBBLE_CONVERSATION` is the phone number (digits only, including country code) of the iMessage conversation you want to bridge. The plugin constructs the chat GUID as `iMessage;-;+{number}`.\n\n3. Register the MCP server in your `~/.claude.json` under the top-level `mcpServers` key:\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"bluebubbles\": {\n         \"command\": \"bun\",\n         \"args\": [\"/absolute/path/to/claudecode-channels-bluebubbles/server.ts\"]\n       }\n     }\n   }\n   ```\n\n4. Start Claude Code with the channel enabled:\n\n   ```bash\n   claude --dangerously-load-development-channels server:bluebubbles\n   ```\n\n## How it works\n\n- The plugin registers as an MCP server with the `claude/channel` capability.\n- It polls the BlueBubbles REST API every 5 seconds for new inbound messages and forwards them into your Claude Code session as `<channel>` events.\n- Claude replies using the `reply` tool, which sends the message back through BlueBubbles as an iMessage.\n- Deduplication is handled by tracking message GUIDs, so each message is delivered exactly once.\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `BLUEBUBBLE_PASS` | yes | | BlueBubbles server password |\n| `BLUEBUBBLE_HOST` | no | `localhost` | BlueBubbles server host |\n| `BLUEBUBBLE_PORT` | no | `1234` | BlueBubbles server port |\n| `BLUEBUBBLE_CONVERSATION` | yes | | Phone number (digits only, with country code) |\n\n",
  "bytes": 2136,
  "sha": "fbcff1dbc1b588abad2181a63d9839d237670dab1e482c31289b5f52a630f3a9",
  "repo_slug": "dmd/claudecode-channels-bluebubbles",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_dmd_claudecode_channels_bluebubbles_blue_a5a0f1dd/readme"
}