iMessage MCP 服务器

⚠️ 免责声明 - 使用风险自负⚠️

该软件按原样提供，不提供任何担保或保证。

使用 AppleScript 发送 iMessage 和管理联系人的 MCP 服务器。

此服务器使用 AppleScript 通过模型上下文协议 (MCP) 与 macOS 的“信息”和“通讯录”应用交互。它将 AppleScript 命令封装在 TypeScript 服务器中，以便您执行以下操作：

查看和搜索您的联系人
向联系人或电话号码发送 iMessage
发送消息时获取确认

特征

资源

通过contacts://all访问您的联系人
查看联系方式，包括姓名、电话号码和电子邮件地址
所有数据都保留在您的本地机器上

工具

search_contacts - 通过姓名、电话或电子邮件查找联系人
- 接受搜索查询并返回匹配的联系人
- 搜索姓名、电话号码和电子邮件地址
send_message - 发送 iMessage
- 获取收件人（电话/电子邮件）和消息内容
- 通过本地信息应用发送
- 返回确认或错误详细信息

安装

安装依赖项：

npm install

构建服务器：

npm run build

配置 Claude Desktop 以使用服务器：

在 MacOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "imessage": {
      "command": "node",
      "args": ["/path/to/imessage-server/build/server.js"]
    }
  }
}

重启Claude桌面
当系统提示时授予权限：
- 通讯录访问
- 消息访问

用法

安装完成后，您可以自然地与 Claude Desktop 对话：

“显示我的联系人”
“搜索名为 Marissa 的联系人”
“发送消息至 555-0123，说我 10 分钟后到”
“给 Alice 发一条 iMessage 询问我们是否还一起吃午饭”

安全说明

所有操作均在您的机器本地进行
没有联系人或消息数据发送到外部服务器
服务器需要 macOS 权限才能访问“通讯录”和“信息”
信息通过你的 iMessage 帐户发送

发展

对于开发和调试，请使用 MCP Inspector：

npx @modelcontextprotocol/inspector node build/server.js

要求

macOS（用于消息和联系人集成）
Node.js 18 或更高版本
克劳德桌面
活跃的 iMessage 帐户

故障排除

如果邮件未发送：

检查“信息”应用是否已登录
验证是否授予权限
在 Claude Desktop 日志中查找错误：

tail -f ~/Library/Logs/Claude/mcp*.log

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

本地服务器使 Claude Desktop 能够与您的 macOS 联系人和消息应用程序进行交互，让您可以通过自然语言命令搜索联系人和发送 iMessage。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Relay Server
emiliobool
-
security
F
license
-
quality
This server allows integration with Discord, enabling message exchanges between Claude and a Discord channel using prompts and notifications.
Last updated -
TypeScript
Claude Desktop API MCP
mlobo2012
A
security
F
license
A
quality
A server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.
Last updated -
1
5
Python
Gmail MCP
vinayak-mehta
-
security
A
license
-
quality
A server that allows Claude to search and retrieve emails from your Gmail account, supporting functions like searching emails, retrieving full content of specific emails, and listing recent messages.
Last updated -
2
Python
Apache 2.0
Gmail MCP Server
ajbr0wn
-
security
F
license
-
quality
An integration server that provides Claude Desktop access to Gmail, enabling users to view recent emails and search their Gmail inbox using natural language commands.
Last updated -
6
Python

View all related MCP servers

iMessage MCP Server