AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompare
Home/
API Integration/
mac_messages_mcp
mac_messages_mcp logo

mac_messages_mcp

Active·★ 334·MIT·Updated 2026-10-21
★ Hidden Gem

Mac Messages MCP is a macOS-only local server that enables various AI-powered clients like Claude, Cursor, and VS Code to interact with the macOS Messages app. It allows for searching, reading, and sending messages, managing contacts, and securely accessing attachments with privacy controls.

mac_messages_mcp sits in the API Integration category, so it is usually better judged by workflow fit, deployment style, and team needs than by isolated features alone. Based on the available metadata, it leans most clearly toward Read recent messages across all conversations or filter by contact/group chat, and fuzzy-search message text.. A representative use case is Show recent messages from the last two hours, or search messages from a contact about a specific topic.. The listed license is MIT. GitHub stars are currently 334. Relevant tags include Python, macOS.

© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.

Guides

This write-up is based on the project's README and public repository data. We have not hand-tested the tool.

#Python#macOS#Messaging#API Integration#AI Tools#Local Server#Chat Automation#Data Access
$ Install
$ brew install uv && uvx mac-messages-mcp
↗ Visit site★ GitHub
01

Features

01Read recent messages across all conversations or filter by contact/group chat, and fuzzy-search message text.
02Find contacts by approximate name and return send-ready phone numbers, and list named group chats.
03Send iMessage with SMS/RCS fallback and check recipient iMessage availability.
04Find attachments by date, sender, and MIME type, handling images (HEIC to PNG conversion) and other files.
05Diagnose Messages and Contacts database permissions from inside the MCP client.
02

Why choose it

+Read recent messages across all conversations or filter by contact/group chat, and fuzzy-search message text.
+Find contacts by approximate name and return send-ready phone numbers, and list named group chats.
+Show recent messages from the last two hours, or search messages from a contact about a specific topic.
+Comes with a clearly listed MIT license.
03

Trade-offs

!Compatibility coverage appears narrow, so your target environment should be validated before adoption.
04

Compatibility

MacOS
Operating System
Verified via docs
Python
Runtime
Verified via docs
05

Quick start

1
$ brew install uv
2
$ uvx mac-messages-mcp
06

Use cases

↳Show recent messages from the last two hours, or search messages from a contact about a specific topic.
↳Find contacts and draft a message, waiting for user confirmation before sending.
↳Locate PDFs sent within the current month without opening them automatically.
↳Diagnose access issues to macOS Messages and Contacts databases for smooth operation.
07

Alternatives

⚡Top VS:
VSmcp-odoo★425→VSsemantic-scholar-mcp★23→VScaldav-mcp★103→

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Compatibility05Quick start06Use cases
VS
marketplaces-mcp-ru
★52
→
mcp-odoo logo
mcp-odoo★ 425
MCP Server for Odoo
VSCompare→
semantic-scholar-mcp logo
semantic-scholar-mcp★ 23
Semantic Scholar MCP server: 14 typed tools for paper search, citation graphs, author profiles, recommendations, PyPI/Docker.
VSCompare→
caldav-mcp logo
caldav-mcp★ 103
🗓️ A CalDAV Model Context Protocol (MCP) server to expose calendar operations as tools for AI assistants.
VSCompare→
marketplaces-mcp-ru logo
marketplaces-mcp-ru★ 52
MCP-сервер для кабинетов Wildberries, Ozon, Яндекс Маркета и Авито: продажи, заказы, остатки, цены, финансы, отзывы через API напрямую, без браузера. 1022 метода schema-driven, safety-гейт на запись. | MCP server for Wildberries, Ozon, Yandex Market and Avito seller APIs. Open-source MIT.
VSCompare→
autodesk-fusion-mcp logo
autodesk-fusion-mcp★ 28
MCP server that runs inside Autodesk Fusion (formerly Autodesk Fusion 360) as an add-in, letting AI agents drive your CAD session over Streamable HTTP. Zero external dependencies.
VSCompare→
Apple-MCPs logo
Apple-MCPs★ 28
Model Context Protocol (MCP) servers that give AI agents local access to macOS apps: Mail, Calendar, Reminders, Messages, Contacts, Notes, Shortcuts, Files, System, and Maps. Unified server plus focused single-app servers.
VSCompare→
mcp-gsc logo
mcp-gsc★ 2.0k
Google Search Console Insights with Claude AI for SEOs
VSCompare→
plane-mcp-server logo
plane-mcp-server★ 346
Plane's Official Model Context Protocol Server 🔌 ⌨️ 🔥
VSCompare→
See all alternatives →
07
Alternatives
carterlasalle /
mac_messages_mcp
↗

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.

334MIT
Last commit2d ago
StatusActive
CategoryAPI Integration
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit