Skip to main content
BlueBubbles is an open-source, self-hosted iMessage server: REST send plus webhooks. This example runs the repo’s shared Claude agent wired to BlueBubbles’s API, with the full Agentcard integration — per-user OAuth connect and the MCP card toolset.

​
Run it

git clone https://github.com/tiny-agent-company/example-implementations
cd example-implementations/bluebubbles
bun install
cp .env.example .env   # add ANTHROPIC_API_KEY
bun run dev            # terminal mode — chat locally, zero vendor credentials
bun run start          # the real BlueBubbles provider: webhook server + sender
In terminal mode you can drive the whole Agentcard flow — ask the agent for a card, tap the connect link it hands you, and watch it mint one in sandbox.

BlueBubbles example on GitHub

The runnable folder — provider, Agentcard wiring, and offline tests.