imessage-mcp
Provides read-only access to your local iMessage history, and optionally allows sending iMessages via the send_message tool.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@imessage-mcpshow my last 10 iMessages from Alice"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
imessage-cli
A monorepo of three Python packages and a Next.js broker that turn your local iMessage history into something an MCP-capable AI (Claude, Cursor, Poke, …) can read — and optionally reply through — without your messages ever leaving your Mac.
Packages (published to PyPI)
Package | Install | What it does |
| Read-only MCP server for your iMessage DB. No hosted service. | |
| Adds a | |
| Connected CLI with account-managed API keys and a stable broker URL. |
Each package has its own README inside packages/<name>/.
Related MCP server: iMCP
Architecture
Claude / Poke / Cursor (MCP client)
│
│ Bearer <api_key>
▼
Next.js broker (backend/) ◀── Supabase auth + Postgres
│ Bearer <tunnel_token>
▼
*.trycloudflare.com tunnel
│
▼
imessage-mcp on your Mac ◀── chat.db (read-only)The broker is plumbing — your messages never leave your Mac.
Repository layout
packages/imessage-mcp/ ← published: read-only MCP server
packages/imessage-mcp-send/ ← published: optional send_message tool
packages/imessage-bridge/ ← published: connected CLI for the broker
backend/ ← Next.js + Supabase broker (not published)
src/imessage_cli/ ← legacy local-only tools (imessage-cli, imessage-ai)The workspace is a uv workspace; packages share a single venv during dev.
Development setup
git clone https://github.com/moritzhwnr/imessage-cli
cd imessage-cli
uv sync # installs all three packages + legacy CLIs in editable mode
uv run imessage-mcp --help
uv run imessage-bridge --helpFor the broker:
cd backend
cp .env.local.example .env.local # fill in Supabase URL + service-role key + encryption key
npm install
npm run dev # http://localhost:3000See backend/supabase/migrations/0001_init.sql for the database schema and backend/.env.local.example for the required env vars.
License
MIT — see LICENSE.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/moritzhwnr/imessage-cli'
If you have feedback or need assistance with the MCP directory API, please join our Discord server