MCP ConfigsMay 12, 2026·2 min read

Mac Messages MCP — iMessage/SMS Bridge

Mac Messages MCP is a Python MCP server for Messages.app on macOS: read chats, send replies, search attachments, and fall back to SMS/RCS.

Agent ready

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Needs Confirmation · 62/100Policy: confirm
Agent surface
Any MCP/CLI agent
Kind
Mcp
Install
Manual
Trust
Trust: Established
Entrypoint
uvx mac-messages-mcp
Universal CLI install command
npx tokrepo install df487610-fc3e-5ad5-b6b5-0274eb9f18db
Intro

Mac Messages MCP is a Python MCP server for Messages.app on macOS: read chats, send replies, search attachments, and fall back to SMS/RCS.

  • Best for: Personal agent workflows on macOS (triage, summaries, replies) for your own messages
  • Works with: macOS 11+; Python 3.10+; uv/uvx; Claude Desktop or Cursor MCP support (per README)
  • Setup time: 10–25 minutes (plus macOS permissions)

Practical Notes

  • GitHub: 280 stars · 22 forks; pushed 2026-05-10 (verified via GitHub API).
  • README requires Full Disk Access so the server can read the local Messages database.
  • README documents progressive attachment access (discover → search → fetch) to reduce accidental data exposure.

Main

Use it responsibly:

  • Only connect it on a machine you control, and treat conversation data as sensitive.
  • Prefer read-only tools for dashboards and summaries; gate “send” behind an explicit confirmation step.
  • If you run both Cursor and Claude Desktop, follow README guidance: run only one server instance to avoid database locks.

This turns iMessage/SMS into a real agent channel while keeping a human in the loop for outbound actions.

FAQ

Q: Why does it need Full Disk Access? A: README says it reads the local Messages database, which macOS protects behind Full Disk Access.

Q: Can it send SMS to Android users? A: README says it automatically chooses iMessage or SMS/RCS based on recipient availability.

Q: How do I reduce privacy risk? A: Use progressive disclosure for attachments and require confirmation before sending messages.

🙏

Source & Thanks

Source: https://github.com/carterlasalle/mac_messages_mcp > License: MIT > GitHub stars: 280 · forks: 42

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets