iMessage MCP server — 26 tools for searching, analyzing, and exploring your entire iMessage history on macOS
If you already use Imessage MCP, the imessage mcp mcp server is the piece that lets your assistant work with it directly. iMessage MCP server — 26 tools for searching, analyzing, and exploring your entire iMessage history on macOS.
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.
imessage-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
search_messages — Full-text search with filters: query, contact, date range, direction, group chat, attachmentsyearly_wrapped — Spotify Wrapped for iMessage — full year summarywho_initiates — Who starts conversations? Initiation ratio per contactstreaks — Consecutive-day messaging streaksget_reactions — Tapback distribution, top reactors, most-reacted messageson_this_day — Messages from this date in past yearsget_conversation — Conversation thread with cursor-based paginationlist_contacts — All contacts with message counts and date rangesget_contact — Deep contact info with stats and yearly breakdownresolve_contact — Fuzzy-match a name, phone number, or email to a contactmessage_stats — Aggregate stats with time-series groupingcontact_stats — Per-contact volumes, trends, and hourly patternsConfiguration is passed through the environment: IMESSAGE_SAFE_MODE, IMESSAGE_SYNC, IMESSAGE_API_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
node --version) 3. Database access for your host application — macOS protects 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 mayPlenty of team communication servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Imessage MCP's toolset — search_messages, yearly_wrapped, who_initiates and 11 more — is a fair guide to whether it matches your workflow. It is maintained by anipotts; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| 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 |
| get_conversation | Conversation thread with cursor-based pagination |
| list_contacts | All contacts with message counts and date ranges |
| get_contact | Deep contact info with stats and yearly breakdown |
| resolve_contact | Fuzzy-match a name, phone number, or email to a contact |
| message_stats | Aggregate stats with time-series grouping |
| contact_stats | Per-contact volumes, trends, and hourly patterns |
| temporal_heatmap | 7x24 activity heatmap (day-of-week by hour) |
| first_last_message | First and last message ever exchanged with a contact |
{
"mcpServers": {
"imessage": {
"command": "npx",
"args": ["-y", "imessage-mcp"]
}
}
}Configuration as documented by the project. Restart the client after saving.
node --version) 3. Database access for your host application — macOS protects 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| Variable | Description | Required |
|---|---|---|
| IMESSAGE_SAFE_MODE | Configuration value read at startup. | Optional |
| IMESSAGE_SYNC | Configuration value read at startup. | Optional |
| IMESSAGE_API_TOKEN | Credential the server authenticates with. | Yes |
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Inbox intelligence — search, read, draft and send Gmail through your assistant with OAuth auto-setup.
Read and write Jira, Confluence, Bitbucket, JSM and Compass from your AI client — with your own permissions.
Read and send Telegram messages through your assistant — chats, channels and history via the client API.
Enables Discord bot integration with Model Context Protocol (MCP) compatible applications like Claude Desktop.
Exposes REST APIs defined by OpenAPI specifications as Model Context Protocol (MCP) tools, facilitating seamless integration into MCP-based workflows.