Apple MCP tools

Apple MCP tools

site icon
2025.04.03 6
TypeScript消息管理笔记管理联系人搜索电子邮件处理提醒事项日历事件网页搜索地图服务交流协作日程管理位置服务开发效率
Apple MCP 是一个基于 MCP 协议的苹果原生工具集合,旨在通过 Claude Desktop 或 Cursor 等客户端提供与苹果原生应用的无缝集成。它支持消息发送、笔记管理、联系人搜索、电子邮件处理、提醒事项、日历事件、网页搜索和地图服务等功能,能够通过命令行或客户端指令实现自动化工作流。
View on GitHub

Overview

基本能力

产品定位

Apple MCP 是一个为苹果设备优化的工具集合,通过 MCP 协议与苹果原生应用(如 Messages、Notes、Contacts、Mail、Reminders、Calendar、Maps 等)进行交互,提供自动化操作和集成服务。

核心功能

  • 消息管理:通过 Apple Messages 应用发送和朗读消息。
  • 笔记管理:在 Apple Notes 应用中列出、搜索和阅读笔记。
  • 联系人搜索:搜索联系人以便发送消息。
  • 电子邮件处理:支持发送、搜索、调度和管理电子邮件,包括附件和多收件人功能。
  • 提醒事项:创建、搜索和管理提醒事项,支持设置截止日期和备注。
  • 日历事件:搜索、列出和创建日历事件,支持自定义日期范围和详细信息。
  • 网页搜索:使用 DuckDuckGo 进行网页搜索并处理结果。
  • 地图服务:搜索位置、保存收藏、获取路线、放置图钉以及管理指南。

适用场景

  • 自动化发送消息或电子邮件。
  • 管理和搜索笔记或提醒事项。
  • 安排和查看日历事件。
  • 通过地图服务查找位置或规划路线。
  • 创建自动化工作流,如读取笔记、查找联系人并发送消息。

使用教程

使用依赖

  • 需要安装 bun,可以通过以下命令安装: bash brew install oven-sh/bun/bun

安装教程

  1. 自动安装(通过 Smithery):
  2. 对于 Claude Desktop: bash npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude
  3. 对于 Cursor: bash npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor
  4. 手动安装
  5. 编辑 claude_desktop_config.json 文件,添加以下内容: json { "mcpServers": { "apple-mcp": { "command": "bunx", "args": ["@dhravya/apple-mcp@latest"] } } }

调试方式

  • 本地开发: bash git clone https://github.com/dhravya/apple-mcp.git cd apple-mcp bun install bun run index.ts

常见问题解答

  • 如何发送消息?:使用指令 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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。