Skip to content
MCP server

iMessage MCP

Let Claude Code and Codex read and send iMessages on a Mac without Full Disk Access

Runs locallyStatus and history
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity