Bring-your-own-data MCP

Your iMessages,
where your AI lives.

imessage-bridge exposes your local iMessage history to any MCP-capable AI — Claude, Poke, Cursor — through a stable broker URL. Messages never leave your Mac. The broker is just plumbing.

01

Install the CLI

One command from PyPI. Runs locally — your messages never leave your Mac.

uv tool install imessage-bridge
Also want to send messages from your AI?
uv tool install 'imessage-bridge[send]'

The [send] extra installs the add-on into the same tool environment. serve then asks whether to enable the send_message tool — or pass --send / --no-send to skip the prompt. Irreversible writes — install only if you understand the risk.

Don't have uv?
curl -LsSf https://astral.sh/uv/install.sh | sh

Official Astral installer. Adds Python 3.13 automatically if missing.

View on GitHub →
02

Sign up and run

All auth happens in your terminal. No web form, no session cookies.

imessage-bridge signup           # create account, save your API key
imessage-bridge serve --public   # spin up the tunnel and register it

The CLI prints a Claude/Cursor/Poke config block with your personal MCP URL and API key. Copy it into your AI client of choice.

Lost your API key? Rotate it.
imessage-bridge new-key

Asks for your email + password, mints a new key, and overwrites the local one. Old keys keep working until you revoke them.

03

Plug into Poke

One-click recipe to wire this MCP server into Poke.

Open Poke recipe →
  1. Click Open Poke recipe above. Poke will ask for your API key.
  2. Back in your terminal, copy the key from the panel printed by imessage-bridge serve --public. Lost it? Run imessage-bridge new-key to mint a fresh one.
  3. Paste it into Poke and save. That's it.

Don't use Poke? The same URL + key works in Claude Desktop, Cursor, and any other MCP-capable client.