wyattjoh/imessage-mcp
Overview
A Model Context Protocol (MCP) server for reading iMessage data from macOS, featuring message retrieval, chat listing, and contact management.
Capabilities
- • database integration
- • github integration
- • mcp client integration
Best For
Model Context Protocol (MCP) server for reading iMessage data on macOS, supporting message retrieval, chat listing, and contact management.
Decision Snapshot
Usage
available
Docs
1 links
Config
5 strong hints
Capabilities
3 key capabilities detected
- • GitHub stars: 24
- • Forks: 7
- • Source provenance count: 1
- • Last seen: 3/18/2026
- • Published: 3/15/2026
Usage
// Get first 20 recent messages && get_recent_messages({ limit: 20, offset: 0 }); && // Get next 20 recent messages (page 2) && get_recent_messages({ limit: 20, offset: 20 });Features
- • Search messages by text content, contact, or date range
- • Get recent messages
- • List all chats/conversations
- • Get all contacts/handles
- • Retrieve messages from specific chats
- • Search macOS Contacts by name with iMessage handle ID correlation
Supported Clients / Integrations
- • database integration
- • github integration
- • mcp client integration
Compatibility Signals
- • GitHub: supports (Detected in parser config/capability hints.)
Prompt Examples
example
• // Get first 20 recent messages && get_recent_messages({ limit: 20, offset: 0 }); && // Get next 20 recent messages (page 2) && get_recent_messages({ limit: 20, offset: 20 });
Notes / Requirements
- • Primary language: TypeScript
- • License: MIT
- • Documentation coverage: medium
- • Parser coverage score: 1.00
- • Source feeds: Awesome MCP Servers (punkpeye)
- • Topic cluster: general
Official Links
Source Information
You can verify all information on this page against the source repository above.
Related MCP Tools
lharries/whatsapp-mcp
An MCP server for searching personal WhatsApp messages, contacts, and sending messages to individuals or groups.
wyattjoh/jmap-mcp
A Model Context Protocol (MCP) server that enables interaction with JMAP email servers, built with Deno and the jmap-jam client library.
PhononX/cv-mcp-server
An MCP Server connecting AI Agents, enabling management of voice messages, conversations, folders, and AI actions.
chaindead/telegram-mcp
A Python tool for Telegram API integration, enabling access to user data, dialog management (chats, channels, groups), message retrieval, sending, and read status handling.
What To Do Next
Continue from this tool into a workflow and a learn guide to shorten implementation time.