AI tools, scored for your job
Get paid to train AI
🤝 You're in the Free & Open Source library — community-built tools you can use without paying. A different concept from our scored AI directory.
Home › Free & Open Source › Therapists › Mac Messages MCP
✦ Free & open sourceTherapists

Mac Messages MCP

Securely query and analyze iMessage conversations via the Model Context Protocol.

Mac Messages MCP for AI Clients

Connect Claude, Cursor, and local MCP clients directly to your macOS Messages database.

Free forever · open source · MIT
✓ Light setup✓ Browser-based✓ Real-time collaboration
6.6
ZEKAI
Essential for local Mac MCP workflows
Free & open source · Therapists
Ease of setup4
Usefulness8
Maintenance9.5
Community5
★ 331
GITHUB
Sep 2026
UPDATED
MIT
LICENSE
🛠 Don't want to self-host? We can set it up →
⚡ Quick answer

This tool is a Model Context Protocol server that bridges your local iMessage database with AI applications like Claude Desktop, Cursor, and Codex. It suits professionals needing local AI interaction with message archives, but requires macOS and specific security permissions.

Runs on
Web
Hosting
Desktop
Languages
Python
License
MIT

What it is

It provides read-only access to your macOS Messages and Contacts databases via specific tools for fuzzy-searching text, filtering by contact or group, and managing attachments. It also enables sending iMessages or SMS fallbacks when explicitly triggered by the client.

Who it's for

It suits macOS users working with local AI tools who need to query past conversations or draft replies programmatically. It does not suit Windows or Linux users, or those unwilling to grant Full Disk Access to their developer tools.

Key features

Fuzzy-Search Message Text

Search message bodies across custom time windows or full history.

Contact and Group Lookup

Find contacts by approximate name and list named group chat identifiers.

Attachment Processing

Find attachments by date and MIME type, handling HEIC conversion and inline images.

Messaging and Fallback

Send iMessages with SMS and RCS fallback for eligible phone recipients.

How to start

Up and running in 3 steps

1
Install the uv package manager and ensure Python 3.10 or newer is available.
2
Grant Full Disk Access to your chosen MCP client or terminal in macOS System Settings.
3
Add the server definition using `uvx mac-messages-mcp` to your client configuration file.
Real talk

Our honest verdict

What's great

  • Operates locally on your Mac for complete data privacy
  • Integrates with popular MCP clients including Claude, Cursor, and VS Code
  • Supports automatic HEIC to PNG image conversion for attachments
  • Includes built-in database permission diagnostics

Where it falls short

  • Restricted exclusively to macOS operating systems
  • Requires granting Full Disk Access and automation permissions to your client app
  • Requires manual configuration of environment variables for non-default phone regions
Cost

Pricing & license

Free under its MIT licence, with no paid hosted option available. The only cost is running it locally on your own macOS hardware.

Paid work

Open remote AI-training roles

883 open remote AI-training roles, updated November 16, 2026; most pay $20–$175 an hour. Zekai lists them free; the application goes to the employer’s platform.

See all open roles →
Compare

Alternatives

Get more

Use it, or have us set it up

📄 Free PDF: Mac Messages MCP for Therapists
A plain-language guide to getting your first result. Sent to your inbox.
🔔 64 people want a full video tutorial — add your vote
🛠 Don't want to set it up yourself?
We'll install, host & configure Mac Messages MCP for you — and train your team.
Get it done for you ↗
Questions

FAQ

Which operating systems are supported?

This tool is macOS-only because it relies directly on the local Messages and Contacts databases.

Can the AI send messages without my confirmation?

No, sending messages requires explicit tool calls and relies on the macOS Messages app being open and signed in.

How do I handle phone numbers from different regions?

You can set the MAC_MESSAGES_REGION environment variable to an ISO 3166-1 alpha-2 code in your client configuration.

Radar

Latest AI news

✉️ The weekly free toolkit
The best new free & open-source tools for Therapists — one short email a week, in your language.
Free · 1 email/week · unsubscribe anytime
Get paid to train AI →

See Zekai first in Google