wyattjoh/imessage-mcp

Overview

A TypeScript implementation of the Model Context Protocol (MCP) server that reads iMessage data from macOS. It exposes iMessage conversations and messages to MCP-compatible clients, allowing language models to access local message history.

Best for

Best for
macOS developers building local AI tools that need read access to iMessage conversations.

Use cases

• Access iMessage conversations for context in AI assistants
• Retrieve message history for local analysis or logging
• Integrate iMessage data into MCP-based workflows

How to use

Install

deno install --global --allow-read --allow-env --allow-sys --allow-ffi -n imessage-mcp jsr:@wyattjoh/imessage-mcp

Tools exposed

• search_messages
• get_recent_messages
• get_chats
• get_handles
• get_messages_from_chat
• search_contacts

Tested with

Claude Desktop

Example client config

{\n  "mcpServers": {\n    "imessage": {\n      "command": "deno",\n      "args": [\n        "run",\n        "--allow-read",\n        "--allow-env",\n        "--allow-sys",\n        "--allow-ffi",\n        "jsr:@wyattjoh/imessage-mcp"\n      ]\n    }\n  }\n}

Notes

A TypeScript implementation of the Model Context Protocol (MCP) server that reads iMessage data from macOS. It exposes iMessage conversations and messages to MCP-compatible clients, allowing language models to access local message history.

27 stars on GitHub. Last updated 2026-03-02. Licensed MIT.

Use cases

• Access iMessage conversations for context in AI assistants
• Retrieve message history for local analysis or logging
• Integrate iMessage data into MCP-based workflows

Pros

• Lightweight and focused solely on reading iMessage data
• Open source TypeScript codebase, easy to audit and modify
• Compatible with any MCP client for standard integration

Cons

• Only works on macOS due to iMessage platform dependency
• Requires permissions to access the iMessage database, which may involve system security restrictions
• Small community (27 stars) may mean limited support and slower updates

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.