Imessage Mcp
by adelaidasofiacommunityv0.1.0
8
5
imessage-mcp is an MCP server that provides AI assistants read-only access to your local iMessage database, allowing users to explore their iMessage history without modifying or uploading any data.
From the registry: macOS-only MCP server that exposes iMessage chat.db to Claude and exports per-chat history to an…
Install & configure
Prerequisites
- requiredmacOSiMessage is macOS-only
- requiredFull Disk AccessGrant the host app (terminal, Claude Desktop, Cursor) Full Disk Access in System Settings → Privacy & Security so it can read ~/Library/Messages/chat.db
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `imessage-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **macOS** — iMessage is macOS-only
- **Full Disk Access** — Grant the host app (terminal, Claude Desktop, Cursor) Full Disk Access in System Settings → Privacy & Security so it can read ~/Library/Messages/chat.db
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","imessage-mcp"]
- optional environment variables:
- `IMESSAGE_DB`: Path to the iMessage SQLite database (example: `~/Library/Messages/chat.db`)
- `IMESSAGE_SAFE_MODE`: Set to '1' to redact all message bodies (metadata only) (example: `0`)
- `IMESSAGE_SYNC`: Sync mode: off|watch|poll:N (example: `off`)
- `IMESSAGE_API_TOKEN`: Bearer token for HTTP/SSE auth (only relevant with --transport http)
Note: Read-only MCP server over the local iMessage chat.db. 26 analytics tools. Also supports streamable-http and SSE transports.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Read-only MCP server over the local iMessage chat.db. 26 analytics tools. Also supports streamable-http and SSE transports.
Tools (6)
search_messages
Full-text search with filters: query, contact, date range, direction, group chat, attachments
yearly_wrapped
Spotify Wrapped for iMessage — full year summary
who_initiates
Who starts conversations? Initiation ratio per contact
streaks
Consecutive-day messaging streaks
get_reactions
Tapback distribution, top reactors, most-reacted messages
on_this_day
Messages from this date in past years
Prerequisites
- • Node.js 18+
- • Node v22.0
Packages
https://github.com/adelaidasofia/imessage-mcp/releases/download/v0.1.0/imessage-mcp.mcpb
mcpbv0.1.0transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- May 20, 2026
- Last commit
- May 13, 2026
- Registry name
- io.github.adelaidasofia/imessage-mcp