Welcome to the official directory for community-led projects within the BlueBubbles ecosystem. This repository serves as a curated list of third-party applications, scripts, and tools that leverage apps in the BlueBubbles ecosystem.
| Project Name | Description | Author | Link |
|---|---|---|---|
| BlueBubbles ChatGPT Agent | A ChatGPT agent that integrates with BlueBubbles (iMessage) and optional Google Calendar + other tools. Built with Spring Boot + OpenAPI. | @omega-bred | Repo |
| Clawdbot | Clawdbot is a personal AI assistant you run on your own devices. It answers you on the channels you already use (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Microsoft Teams, WebChat), plus extension channels like BlueBubbles, Matrix, Zalo, and Zalo Personal. It can speak and listen on macOS/iOS/Android, and can render a live Canvas you control. The Gateway is just the control plane — the product is the assistant. | @clawdbot | Repo |
| BlueBubbles MCP Server | A Model Context Protocol (MCP) server that provides Claude Desktop with the ability to interact with a BlueBubbles instance for iMessage management. | @jfiggins | Repo |
| BlueBubbles for HomeAssistant | This integration allows you to send messages (iMessage/RCS/SMS/MMS) from Home Assistant using a BlueBubbles server. It connects to your BlueBubbles instance and exposes a service for sending messages. | @jfiggins | Repo |
If you are looking to build your own project, please refer to our core technical documentation:
- Server API: The Electron server exposes a REST API (standard port 1234) and a Socket.IO connection for real-time events.
- Security: Ensure all third-party apps respect the sensitive nature of iMessage data and utilize our encrypted communication protocols.
We welcome all contributions! To add your project to this list:
- Fork this repository.
- Add your project to the appropriate table in this
README.md. - Submit a Pull Request.
These projects are developed by the community and are not officially maintained by the BlueBubbles Development Team. Use them at your own discretion.