Apple Messages

Apple Messages MCP

用于 macOS 上 Apple Messages 的 MCP 服务。

可通过 Messages.app 访问消息历史记录、搜索对话并发送消息。查看历史记录需要“完全磁盘访问权限”，发送消息需要“自动化”访问权限。

适用场景

• 仅使用 Messages 的工作流
• 无需使用一体化服务即可查看消息历史记录和发送消息
• 按应用更严格地隔离权限

功能

• 分页列出对话
• 搜索消息并查看附件元数据
• 发送和回复消息
• 为受上下文限制的客户端提供工具发现辅助功能 search_tools 和 get_tool_info
• 未读和最近对话资源
• 区分历史记录访问故障与自动化故障的运行状况检查
• 权限恢复：messages_permission_guide、messages_recheck_permissions

在此 Mac 上安装

uvx apple-messages-mcp

git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

在 AI Agent 中安装

{
  "mcpServers": {
    "apple-messages": {
      "command": "uvx",
      "args": ["apple-messages-mcp"],
      "env": {
        "APPLE_MESSAGES_MCP_SAFETY_MODE": "full_access"
      }
    }
  }
}

claude mcp add --transport stdio --scope user apple-messages -- uvx apple-messages-mcp

传输方式

stdio 是默认且推荐的传输方式。设置 APPLE_MESSAGES_MCP_TRANSPORT=streamable-http（可选设置 APPLE_MESSAGES_MCP_HOST 和 APPLE_MESSAGES_MCP_PORT）即可改用 Streamable HTTP 服务。

macOS 权限

• 发送和回复消息需要 Messages 的“自动化”访问权限
• 从 ~/Library/Messages/chat.db 读取历史记录、搜索消息和获取附件元数据需要“完全磁盘访问权限”
• messages_health 通过 NSRunningApplication 检查运行状态，不会发送 Apple Events，也不会请求“自动化”访问权限。Messages 已关闭时，会报告 automation_access_status: "not_probed"；Messages 正在运行时，会报告 "unknown"。这两种情况都不表示权限遭到拒绝。
• 未验证授权时，现有的 automation_access 和发送能力布尔值均为 false。用户已授权操作时，明确调用的发送工具仍可使用。automation_access_status 和 automation_access_error_code 可区分跳过检查、授权状态未知、权限被拒绝和命令执行失败。明确调用发送或回复仍会检查授权，并可能打开 Messages 或显示 macOS 权限提示。
• 诊断子进程的超时时间为 5 秒。明确调用自动化操作的超时时间为 30 秒；发送超时后，重试前请先检查消息是否已送达。

启动清单

• 将 uvx apple-messages-mcp（或克隆仓库中的 AppleMessages-MCP/start.sh）添加到 MCP 客户端
• 重新加载或重新连接客户端，以便将 Messages 工具集加载到上下文中
• 首先调用 messages_health
• 如果任一权限未开放，请调用 messages_permission_guide
• 更改 macOS 权限后，请调用 messages_recheck_permissions

提示词说明

• tools/list 会返回完整的 Messages 工具集。上下文受限的客户端可以先使用 search_tools，再使用 get_tool_info 获取所需的 Messages 工具信息。
• 如果用户提到某个人，发送或回复前请先通过 Contacts 确认收件人。
• 如果 Contacts 返回多个匹配结果，请确认用户指的是哪一位。
• messages_send_message、messages_send_attachment 和 messages_reply_in_conversation 可选接受 service_name 参数，值为 iMessage、SMS 或 RCS。不指定时，新消息会通过 iMessage 发送，一对一回复则使用会话中最新消息的服务类型：SMS 会话继续使用 SMS，RCS 会话使用 RCS，若不可用则回退到 SMS。系统会选择该服务类型下第一个已启用的 Messages 账户。SMS 和 RCS 通过配对的 iPhone 发送，且需要为这台 Mac 开启“短信转发”。如果没有匹配的账户，这些工具会返回 SERVICE_UNAVAILABLE，而不会发送消息；因此，在未开启“短信转发”的 Mac 上回复 SMS 会话会失败，除非你重试时将 service_name 设为 iMessage，或开启“短信转发”。RCS 需要 macOS 15 或更高版本；在较旧的 macOS 上，RCS 会话会回退到 SMS。群组回复始终使用群组现有的服务类型，如果指定了不同的 service_name，则会被拒绝并返回 INVALID_INPUT。响应中的 service_name 表示实际使用的服务类型。

相关内容

• Apple-Tools-MCP