carterlasalle/mac_messages_mcp

Overview

An MCP server for macOS that exposes iMessage conversations to LLMs via the Model Context Protocol. It validates phone numbers, processes attachments, manages contacts, handles group chats, and supports sending and receiving messages. The server reads from the local iMessage database.

Best for

Best for
Developers building macOS-native AI agents that need iMessage access

Use cases

• Query iMessage history for context in an AI assistant
• Analyze message patterns over time with natural language
• Automate sending iMessages from an LLM agent

How to use

Install

yarn dlx @modelcontextprotocol/inspector uvx mac-messages-mcp

Tools exposed

• tool_get_recent_messages
• tool_fuzzy_search_messages
• tool_find_contact
• tool_get_chats
• tool_search_attachments
• tool_get_attachment
• tool_check_imessage_availability
• tool_check_db_access
• tool_check_contacts
• tool_check_addressbook
• tool_send_message

Tested with

Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT

Example client config

{\n    "mcpServers": {\n        "messages": {\n            "command": "uvx",\n            "args": [\n                "mac-messages-mcp"\n            ]\n        }\n    }\n}

Notes

An MCP server for macOS that exposes iMessage conversations to LLMs via the Model Context Protocol. It validates phone numbers, processes attachments, manages contacts, handles group chats, and supports sending and receiving messages. The server reads from the local iMessage database.

292 stars on GitHub. Last updated 2026-05-10. Licensed MIT.

Use cases

• Query iMessage history for context in an AI assistant
• Analyze message patterns over time with natural language
• Automate sending iMessages from an LLM agent

Pros

• Leverages official MCP protocol for easy integration with LLM hosts
• Handles complex iMessage features like group chats and attachments
• Open source with active development (292 stars)

Cons

• Requires macOS with iMessage set up and local database access
• Read and write access to iMessage database may pose privacy risks
• Depends on Apple’s iMessage database schema which could change with OS updates

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