Is Imessage MCP Server safe to use?

Imessage MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install Imessage MCP Server?

Imessage MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Imessage MCP Server do?

Imessage MCP Server provides 26 tools: search_messages, get_conversation, list_contacts, get_contact, resolve_contact and 21 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Imessage MCP Server?

Imessage MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is Imessage MCP Server actively maintained?

Imessage MCP Server is actively maintained — last commit was 6 days ago. It has 8 GitHub stars.

Imessage MCP Server

imessage-mcp

25 tools for searching, analyzing, and exploring your iMessage history on macOS.

8 112/wk 26 tools GitHub npm

No known CVEs

No license

Actively maintained

Last commit 6d ago

Works with most clients

Transport: stdio, sse, http

26 tools · ~1.1k tok

Grade B · 0.6% of 200K ctx

Edit this pageView history

Communication Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "imessage": {
      "args": [
        "-y",
        "imessage-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-anipotts-imessage-mcp)](https://mcppedia.org/s/io-github-anipotts-imessage-mcp)

Read me

What Imessage MCP Server does

26 tools for locally exploring your iMessage history with AI.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'imessage-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

78/100across 5 weighted dimensions

How we score →

0255075100

−22

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked imessage-mcp against OSV.dev.

Inventory

Tools (26)

Click any tool to inspect its schema.

~1.1k tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Imessage MCP Server safe to use?: Imessage MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Imessage MCP Server?: Imessage MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Imessage MCP Server do?: Imessage MCP Server provides 26 tools: search_messages, get_conversation, list_contacts, get_contact, resolve_contact and 21 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Imessage MCP Server?: Imessage MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is Imessage MCP Server actively maintained?: Imessage MCP Server is actively maintained — last commit was 6 days ago. It has 8 GitHub stars.

Similar servers

Others in communication / productivity

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

85.9k 5

Mac_messages_mcp95

An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.

279 4

io.github.miroapp/mcp-server95

Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.

104 7

Scrumboy95

a self-hosted project management & Kanban solution + Instant shareable boards

238 1

MCP Security Weekly

Get CVE alerts and security updates for Imessage MCP Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Communication Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "imessage": {
      "args": [
        "-y",
        "imessage-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-anipotts-imessage-mcp)](https://mcppedia.org/s/io-github-anipotts-imessage-mcp)

Read me

What Imessage MCP Server does

26 tools for locally exploring your iMessage history with AI.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'imessage-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

imessage-mcp

26 tools for locally exploring your iMessage history with AI.

if this helped you, star it. it helps others find it.

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.

Read-only access to 2 local files (chat.db + AddressBook). Zero network requests. Nothing is written, uploaded, or shared. All 26 tools are annotated readOnlyHint: true — your MCP client can auto-approve every call without prompts.

Install

npm install -g imessage-mcp

Or run without installing:

npx imessage-mcp doctor

Smithery: One-click install via the Smithery registry — search for imessage-mcp.

Add to your AI client

# Claude Code (one command)
claude mcp add imessage -- npx -y imessage-mcp

# Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "imessage": {
      "command": "npx",
      "args": ["-y", "imessage-mcp"]
    }
  }
}

See Setup for Cursor, Windsurf, VS Code, Codex CLI, Cline, JetBrains, and Zed.

Claude Code Plugin

For slash commands and agents:

claude plugin add anipotts/imessage-mcp

Prerequisites

macOS (iMessage is macOS-only)
Node.js 18+ (node --version)
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.
Messages in iCloud enabled on your Mac (if you use multiple devices) — see iCloud Sync & Multiple Devices

Privacy & Security

imessage-mcp reads your local iMessage database in read-only mode. No data leaves your machine. Nothing is written, modified, uploaded, or shared.

Path	Access	Purpose
`~/Library/Messages/chat.db`	Read-only	Your iMessage database
`~/Library/Application Support/AddressBook/`	Read-only	Contact name resolution

No other files are accessed. No external APIs are called.

chat.db --> [imessage-mcp] --> stdio/http --> [Your MCP Client] --> AI Provider
  ^                                              ^
  Your Mac only                         Already authorized by you

What Can You Ask?

Once connected, ask your AI assistant anything about your messages in plain language:

"Give me my 2024 iMessage Wrapped"
"Do I always text first with [name]?"
"What's my longest texting streak?"
"Who reacts to my messages the most?"
"What was the first text I ever sent my partner?"
"What was I texting about on this day last year?"
"Do I double-text [name] a lot?"
"Who have I lost touch with?"

<detai

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

78/100across 5 weighted dimensions

How we score →

0255075100

−22

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked imessage-mcp against OSV.dev.

Inventory

Tools (26)

Click any tool to inspect its schema.

~1.1k tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Imessage MCP Server safe to use?: Imessage MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Imessage MCP Server?: Imessage MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Imessage MCP Server do?: Imessage MCP Server provides 26 tools: search_messages, get_conversation, list_contacts, get_contact, resolve_contact and 21 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Imessage MCP Server?: Imessage MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is Imessage MCP Server actively maintained?: Imessage MCP Server is actively maintained — last commit was 6 days ago. It has 8 GitHub stars.