mac_messages_mcp
mac_messages_mcp is an MCP server, listed under databases. Its repository has 334 GitHub stars and is licensed under MIT; we last read it on 2026-10-22.
This server connects to your iMessage database using the Model Context Protocol (MCP) to enable language models to query and analyze iMessage conversations. It supports phone number validation, attachment processing, contact management, group chat handling, and message sending/receiving.
Install
MCP servers are packaged differently from each other -- some run via npx, some as a Docker image, some as a plain script you clone and run. mac_messages_mcp’s own README did not state one plainly enough for this page to quote it rather than guess, so it will not guess. The repository below states it.
What it reaches, and what it needs
Maintenance
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.
What mac_messages_mcp can do
18 tools documented in its README. An AI client calls these by name.
tool_get_recent_messages- Read recent messages, filtered by contact, group chat ID, date range, or unread state; page with `limit`/`offset`
tool_fuzzy_search_messages- Search message bodies by approximate text match, scoped to a contact or chat; defaults to 30 days, or `hours=0`
tool_list_conversations- List every conversation with kind, message count, unread count, and last activity
tool_wait_for_new_messages- Block until a message newer than a ROWID cursor arrives, or the timeout expires
tool_find_contact- Fuzzy-match a name in Contacts and return phone numbers
tool_get_chats- List named group chats and their identifiers
tool_search_attachments- Find attachment metadata by date, contact, MIME type, and limit
tool_search_attachment_contents- Search inside attachment text/PDF contents by date, contact, and MIME type
tool_get_attachment- Fetch one attachment by ID, inline when supported or as a local path
tool_check_imessage_availability- Check likely iMessage availability for a phone number or email
tool_check_db_access- Diagnose access to `~/Library/Messages/chat.db`
tool_check_contacts- Return a contact count and a small sample
tool_check_addressbook- Diagnose Contacts/AddressBook database access
tool_send_message- Send one direct or group message through Messages.app, optionally with file attachments and elicitation approval
tool_create_contact- Create one Contacts.app entry with a phone number
tool_schedule_message- Queue a message for later delivery while this server process runs
tool_list_scheduled_messages- List the in-process scheduled-message queue and its status
tool_cancel_scheduled_message- Cancel one pending scheduled message
Read from the README; names are kept only if the README contains them.
mac_messages_mcp compared with similar servers
| Server | Reaches | Needs | Stars | Last update | Licence |
|---|---|---|---|---|---|
| mac_messages_mcp (this page) | — | None listed | 334 | 2026-10-21 | MIT |
| CodeGraphContext | neo4j | NEO4J_PASSWORD | 4,354 | 2026-10-22 | MIT |
| dbhub | mysql, postgres, sqlite | None listed | 3,702 | 2026-10-21 | MIT |
| mcp-server-mysql | mysql | None listed | 2,173 | 2026-07-27 | MIT |
| mysql_mcp_server | mysql | MYSQL_PASSWORD | 1,402 | 2026-08-02 | MIT |
| server | mysql | MYSQL_ROOT_PASSWORD | 874 | 2025-08-09 | MIT |
Ranked by services in common with mac_messages_mcp, then by stars. Figures are from each repository when we last read it.
Common questions about mac_messages_mcp
- What does mac_messages_mcp do?
- This server connects to your iMessage database using the Model Context Protocol (MCP) to enable language models to query and analyze iMessage conversations. It supports phone number validation, attachment processing, contact management, group chat handling, and message sending/receiving.
- How do I install mac_messages_mcp?
- Its README did not state an install command plainly enough for us to quote one, so we do not guess. The repository has the instructions: https://github.com/carterlasalle/mac_messages_mcp
- Is mac_messages_mcp official and is it maintained?
- We found nothing naming it as a vendor’s official server. Its repository has 334 GitHub stars and its state in our directory is listed. Its last commit we recorded was on 2026-10-21.
- What licence does mac_messages_mcp use?
- The repository declares the MIT licence.
More MCP servers for databases
- CodeGraphContext4,354 stars
- dbhub3,702 stars
- mcp-server-mysql2,173 stars
- mysql_mcp_server1,402 stars
- server874 stars
- supabase-mcp-server833 stars