# iMessage MCP

> iMessage MCP is an open-source MCP server for communication. Let Claude Code and Codex read and send iMessages on a Mac without Full Disk Access. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Website:** https://0xroots.github.io/imessage-mcp/
- **Repository:** https://github.com/0xroots/imessage-mcp
- **MCP Registry name:** io.github.0xroots/imessage-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add imessage-mcp -- npx -y https://github.com/0xroots/imessage-mcp/releases/download/v0.4.0/imessage-mcp-0.4.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [Postwith](https://ai-powered.com/mcp/postwith): Postwith is an MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/imessage-mcp
