iMessage MCP
Let Claude Code and Codex read and send iMessages on a Mac without Full Disk Access
- Pricing
- Open source
- Platforms
- macOS, CLI
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- 2 days ago
About iMessage MCP
iMessage MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
The usual way to give an AI tool your messages is to grant it Full Disk Access. This project avoids that: you pick the Messages folder once in a normal macOS panel and the app keeps a read-only, app-scoped bookmark to it inside the App Sandbox, with no network entitlement.
An MCP adapter talks to the app over a local socket. Each connection needs your approval, and you choose all chats or selected ones, how long the bridge runs and how many messages may be read. Sending always opens a confirmation showing the exact recipient and full text, and nothing leaves until you press Send.
The README notes some limits: certain archived message bodies cannot be decoded yet, the request-ID journal holds 1,000 entries, and other processes running as you could start the adapter, so approve only requests you started.
Install
Run in a terminal
claude mcp add imessage-mcp -- npx -y https://github.com/0xroots/imessage-mcp/releases/download/v0.4.0/imessage-mcp-0.4.0.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/0xroots/imessage-mcp/releases/download/v0.4.0/imessage-mcp-0.4.0.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/0xroots/imessage-mcp/releases/download/v0.4.0/imessage-mcp-0.4.0.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"imessage-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/0xroots/imessage-mcp/releases/download/v0.4.0/imessage-mcp-0.4.0.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/0xroots/imessage-mcp/releases/download/v0.4.0/imessage-mcp-0.4.0.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"imessage-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/0xroots/imessage-mcp/releases/download/v0.4.0/imessage-mcp-0.4.0.mcpb"
]
}
}
}Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- list_conversations
- Lists the chats you allowed.
- get_messages
- Reads messages from an allowed chat, with paging.
- search_messages
- Searches message text with direction and date filters.
- get_recent_messages
- Returns messages since a date.
- get_attachment_metadata
- Returns attachment names and types, never contents.
- send_message
- Sends one message after on-screen confirmation.
What it does
- No Full Disk Access
- A read-only bookmark to the Messages folder replaces system-wide permission.
- Sandboxed, no network
- The app has no network entitlement; text leaves only through the AI tool you connect.
- Per-connection approval
- Choose selected or all chats, a time limit and message limits, and stop with one click.
- Confirmed sending
- The recipient and full text are shown before anything is sent.
- Attachment metadata only
- Tools return attachment names and types, never contents.
- Plugins for Claude Code and Codex
- Install through a plugin marketplace or add the stdio command to any client.
Good for
- Search old conversations for a date, address or plan
- Summarise recent messages from one chat
- Draft a reply and send it after you confirm
- Find which chats mention a topic since a given date
Pricing
Open source
Free and open source
Prices change. Check 0xroots.github.io before you buy.
iMessage MCP FAQ
Does it need Full Disk Access?
No. You choose the Messages folder in a standard file panel and the app keeps a read-only bookmark.
Can an AI tool send without asking?
No. Each message shows its recipient and text in a confirmation window and is sent only after you press Send.
What does it require?
macOS 13 or later; install with the Homebrew cask, the DMG, or by building from source with an Apple Development certificate.
Which clients work?
Any client that supports stdio MCP servers, including Claude Code and Codex.
Is iMessage MCP free?
Yes. iMessage MCP is open source, so you can use and self-host it for free.
How do I add iMessage MCP to Claude Code?
Run this command in your terminal: claude mcp add imessage-mcp -- npx -y https://github.com/0xroots/imessage-mcp/releases/download/v0.4.0/imessage-mcp-0.4.0.mcpb
What are the best alternatives to iMessage MCP?
The closest alternatives to iMessage MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to iMessage MCP

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity