# 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.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
# install uv first (per README)
brew install uv

# run the MCP server (stdio)
uvx mac-messages-mcp

# Claude Desktop config (snippet)
# { "mcpServers": { "messages": { "command": "uvx", "args": ["mac-messages-mcp"] } } }
```

## 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

---

<!-- ZH -->

## 快速使用

```bash
# 先安装 uv（README 推荐）
brew install uv

# 运行 MCP server（stdio）
uvx mac-messages-mcp

# Claude Desktop 配置（片段）
# { "mcpServers": { "messages": { "command": "uvx", "args": ["mac-messages-mcp"] } } }
```

## 简介

Mac Messages MCP 是 Python 编写的 MCP server，可让助手在你的 Mac 上读取/发送 Messages.app 对话，支持附件检索，并在无 iMessage 时自动回落到 SMS/RCS。

- **适合谁：** macOS 个人助手：对自己的消息做总结、分流与草拟回复
- **可搭配：** macOS 11+；Python 3.10+；uv/uvx；Claude Desktop 或 Cursor 的 MCP 支持（见 README）
- **准备时间：** 10–25 分钟（另需配置 macOS 权限）

## 实战建议

- GitHub：280 stars · 22 forks；最近更新 2026-05-10（GitHub API 验证）。
- README 要求为终端/应用授予 Full Disk Access，才能读取本地 Messages 数据库。
- README 采用“渐进式附件访问”（发现→搜索→获取），降低意外暴露数据的风险。

## 主要内容

建议按“可控边界”使用：

- 只在你完全控制的设备上使用，把对话数据当作敏感信息处理。
- 做摘要/分流时尽量只读；对“发送消息”加显式确认（HITL）。
- 如果同时用 Cursor 和 Claude Desktop，按 README 建议只运行一个实例，避免冲突/锁库。

这样可以把 iMessage/SMS 变成 agent 的真实工作通道，同时对外发动作保留人工把关。

### FAQ

**为什么需要 Full Disk Access？**
答：README 表示要读取本地 Messages 数据库，macOS 对其做了权限保护。

**能给 Android 发短信吗？**
答：README 表示会根据收件人是否可用 iMessage 自动选择 iMessage 或 SMS/RCS。

**如何降低隐私风险？**
答：按渐进式附件访问流程，并在发送消息前强制二次确认。

## 来源与感谢

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


---
Source: https://tokrepo.com/en/workflows/mac-messages-mcp-imessage-sms-bridge
Author: MCP Hub