Last updated
March 16, 2026
MCP profile
iMessage MCP
25 tools for searching, analyzing, and exploring your iMessage history on macOS.
GeneralPackageJavaScript/TypeScriptOpen SourceExternal
Visibility
Public
ByRegistry
About This MCP Server
imessage-mcp reads ~/Library/Messages/chat.db using better-sqlite3 in read-only mode with query_only = ON. Zero network requests. Contact names are resolved from your macOS AddressBook automatically.
On macOS 14 (Sonoma) and later, Apple changed how message text is stored. Some messages have NULL in the text column but contain the actual text in the attributedBody binary blob. imessage-mcp extracts text from this blob automatically so no messages are left behind.
All 26 tools are annotated with readOnlyHint: true so MCP clients can auto-approve them without user prompts.
Tools & Endpoints2
Specifications
Status
live
Industry
General
Category
General
Server type
Package
Language
JavaScript/TypeScript
License
Open Source
Verified
Yes
Requirements
- 1. macOS (iMessage is macOS-only) 2. Node.js 18+ (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 already have this permission. 4. Messages in iCloud enabled on your Mac (if you use multiple devices) — see iCloud Sync & Multiple Devices
Hosting
Hosting Options
- Package
API
Integrate this server into your application. Choose a connection method below.
1
Install
Install command
JavaScript/TypeScript
npm install -g imessage-mcp2
Configure
Configuration
json
{
"mcpServers": {
"imessage": {
"command": "npx",
"args": ["-y", "imessage-mcp"]
}
}
}Performance
Usage
Quick Reference
- Name
- iMessage MCP
- Function
- 25 tools for searching, analyzing, and exploring your iMessage history on macOS.
- Available Tools
- 26 tools across 10 categories. All read-only. All annotated with readOnlyHint: true., <summary><strong>All 26 tools</strong></summary>
- Transport
- Package
- Language
- JavaScript/TypeScript
- Install
- npm install -g imessage-mcp
- Source
- External (Registry)
- License
- Open Source
Get started
Ready to integrate this MCP server?
Book a demo to see how this server fits your workflow, or explore the full catalog.