imessage-mcp
Active·★ 27·MIT·Updated 2026-10-20
imessage-mcp connects your LLM assistant to your Mac's Apple Messages history, providing read-only tools to search and analyze iMessage, SMS, MMS, and RCS data. It runs locally, keeps its search index in memory, and offers various privacy modes for data disclosure.
#iMessage#Message History#LLM Tool#macOS#Data Analysis#Privacy#API Integration#Messaging Analytics
01
Features
01Search and analyze iMessage, SMS, MMS, and RCS history.
02Read detailed conversation timelines including edits and reactions.
03Count messages and calculate communication metrics.
04Flexible privacy settings (full, redacted, aggregate) for data disclosure.
05Local, in-memory search index with no telemetry collection.
02
Compatibility
macOS
OS
Verified via docs
Node.js
Runtime
Verified via docs
Apple Messages
Data Source
Verified via docs
03
Quick start
1
$ umask 077
2
$ test -e "$HOME/.imessage-mcp-reference-key" || openssl rand -base64 32 > "$HOME/.imessage-mcp-reference-key"
3
$ test -e "$HOME/.imessage-mcp-database-id" || openssl rand -base64 32 > "$HOME/.imessage-mcp-database-id"
4
$ export IMESSAGE_REFERENCE_KEY_FILE="$HOME/.imessage-mcp-reference-key"
5
$ export IMESSAGE_DATABASE_ID_FILE="$HOME/.imessage-mcp-database-id"
6
$ npx -y [email protected] doctor --contacts none --privacy redacted
04
Use cases
↳Find specific messages about a topic.
↳Review recent conversations.
↳Analyze message activity and trends.
↳Integrate iMessage history with LLM assistants.
↳Identify and resolve contact information for messaging.
05
Alternatives
mac_messages_mcp★ 334
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.
telegram-mcp-readonly★ 13
Read-only Telegram MCP server. Search chats, read messages, and download attachments from any MCP client.
AppleMCP★ 1
Native macOS MCP server — secure local access to Mail, Calendar, Contacts, Notes, Reminders, Photos & Apple Intelligence for AI assistants
Dataverse-skills★ 247
Microsoft Dataverse skills for AI coding agents. Wraps the Dataverse MCP server, Dataverse CLI, Python SDK, and PAC CLI behind specialist skills for building, querying, deploying, and administering Dataverse environments.
tonghuasun-agent★ 263
同花顺免费开源AI插件FQGate（原插件名 tonghuasun-agent）：为 Codex、Claude Code、DeepSeek 等 AI 工具提供本机 A 股实时行情、K 线、Level-2、资讯、账户查询与可选交易能力。
Comments
Log in to leave a comment
No comments yet. Be the first!