> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# BlueBubbles

> Claude agent on BlueBubbles, with Agentcard cards per user

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](/companies/examples/overview) — per-user OAuth connect and the MCP card toolset.

## Run it

```bash theme={null}
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.

<Card title="BlueBubbles example on GitHub" icon="github" href="https://github.com/tiny-agent-company/example-implementations/tree/main/bluebubbles">
  The runnable folder — provider, Agentcard wiring, and offline tests.
</Card>