Apple MCP Server

by Dhravya
Verified

local-only server

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

Integrations

  • Allows access to Apple native features including Messages, Notes, Contacts, Emails, and Reminders

  • Planned integration to search and open music in Apple Music app (marked as TODO)

Apple MCP 工具

这是针对MCP 协议的苹果原生工具集合。

这是有关如何进行设置的分步视频,并附带演示。 - https://x.com/DhravyaShah/status/1892694077679763671

{ "mcpServers": { "apple-mcp": { "command": "bunx", "args": ["--no-cache", "apple-mcp@latest"] } }

快速安装

要通过Smithery自动为 Claude Desktop 安装 Apple MCP:

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude

...对于光标,你可以执行以下操作:

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor

特征

  • 消息:
    • 使用 Apple Messages 应用发送消息
    • 读出消息
  • 笔记:
    • 列出笔记
    • 在 Apple Notes 应用中搜索和阅读笔记
  • 联系方式:
    • 搜索联系人以发送消息
  • 电子邮件:
    • 发送具有多个收件人(收件人、抄送人、密送人)和文件附件的电子邮件
    • 使用自定义查询、邮箱选择和结果限制来搜索电子邮件
    • 安排将来发送的电子邮件
    • 列出并管理预定的电子邮件
    • 检查全局或每个邮箱的未读电子邮件数量
  • 提醒:
    • 列出所有提醒和提醒列表
    • 按文本搜索提醒
    • 创建带有可选截止日期和注释的新提醒
    • 打开“提醒事项”应用查看具体提醒事项
  • 日历:
    • 搜索可自定义日期范围的日历事件
    • 列出即将发生的事件
    • 创建带有标题、位置和注释等详细信息的新日历事件
    • 在日历应用中打开日历事件
  • 网页搜索:
    • 使用 DuckDuckGo 搜索网页
    • 从搜索结果中检索和处理内容
  • 地图:
    • 搜索位置和地址
    • 将位置保存到收藏夹
    • 获取地点之间的路线
    • 在地图上放置图钉
    • 创建并列出指南
    • 将地点添加到指南
  • TODO:在 Apple Photos 应用中搜索并打开照片
  • TODO:在 Apple Music 应用中搜索并打开音乐

您还可以通过菊花链式命令创建工作流程。例如:“您能否帮我查看一下我在会议上遇到的人员的记录,找到他们的联系方式和邮箱地址,并给他们发一条消息,感谢他们的宝贵时间?”

(有用!)

手动安装

你只需要 bun,使用brew install oven-sh/bun/bun安装

现在,使用以下命令编辑您的claude_desktop_config.json

{ "mcpServers": { "apple-mcp": { "command": "bunx", "args": ["@dhravya/apple-mcp@latest"] } } }

用法

现在,让 Claude 使用apple-mcp工具。

Can you send a message to John Doe?
find all the notes related to AI and send it to my girlfriend
create a reminder to "Buy groceries" for tomorrow at 5pm

本地开发

git clone https://github.com/dhravya/apple-mcp.git cd apple-mcp bun install bun run index.ts

享受!

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

通过 MCP 协议实现与 Apple 应用程序(如信息、备忘录和通讯录)的交互,以使用自然语言发送消息、搜索和打开应用程序内容。

  1. Quick install
    1. Features
      1. Manual installation
      2. Usage
    2. Local Development
      ID: gq2qg6kxtu