Tools for securely exploring your iMessage history with AI. Spotify Wrapped for texts, conversation analytics, search, streaks, and more. Read-only MCP server for macOS.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"imessage": {
"args": [
"-y",
"imessage-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Tools for securely exploring your iMessage history with AI. Spotify Wrapped for texts, conversation analytics, search, streaks, and more. Read-only MCP server for macOS.
This server supports HTTP transport. Be the first to test it — help the community know if it works.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked imessage-mcp against OSV.dev.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationBe the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in entertainment
The official MCP Server for the Mux API
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
A Model Context Protocol (MCP) server that gives Claude direct control over Strudel.cc for AI-assisted music generation and live coding.
MCP server for *arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr
MCP Security Weekly
Get CVE alerts and security updates for Imessage Mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
26 tools for locally exploring your iMessage history with AI.
if this helped you, star it. it helps others find it.
An MCP server that gives AI assistants read-only access to your local iMessage database. Nothing is written, modified, or uploaded. Your messages stay on your Mac; the AI only sees what you ask about.
Read-only access to 2 local files (
chat.db+AddressBook). Zero network requests. Nothing is written, uploaded, or shared. All 26 tools are annotatedreadOnlyHint: true— your MCP client can auto-approve every call without prompts.
npm install -g imessage-mcp
Or run without installing:
npx imessage-mcp doctor
Smithery: One-click install via the Smithery registry — search for imessage-mcp.
# Claude Code (one command)
claude mcp add imessage -- npx -y imessage-mcp
# Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"imessage": {
"command": "npx",
"args": ["-y", "imessage-mcp"]
}
}
}
See Setup for Cursor, Windsurf, VS Code, Codex CLI, Cline, JetBrains, and Zed.
For slash commands and agents:
claude plugin add anipotts/imessage-mcp
node --version)chat.db with its Application Data permission. Grant access in: System Settings > Privacy & Security > Full Disk Access and enable the app running the MCP server (your terminal, Claude Desktop, or Cursor). GUI apps like Claude Desktop and Cursor may already have this permission.imessage-mcp reads your local iMessage database in read-only mode. No data leaves your machine. Nothing is written, modified, uploaded, or shared.
| Path | Access | Purpose |
|---|---|---|
~/Library/Messages/chat.db | Read-only | Your iMessage database |
~/Library/Application Support/AddressBook/ | Read-only | Contact name resolution |
No other files are accessed. No external APIs are called.
chat.db --> [imessage-mcp] --> stdio/http --> [Your MCP Client] --> AI Provider
^ ^
Your Mac only Already authorized by you
Once connected, ask your AI assistant anything about your messages in plain language:
<detai