Apple Reminders MCP Server

Apple Reminders MCP Server

site icon
2025.03.22 34
TypeScript日程管理任务跟踪日程管理
Apple Reminders MCP Server 是一个提供与 macOS 上的 Apple Reminders 原生集成的 Model Context Protocol (MCP) 服务器。通过标准化接口,用户可以方便地与 Apple Reminders 进行交互,包括创建、管理和查看提醒事项。
View on GitHub

Overview

基本能力

产品定位

Apple Reminders MCP Server 是一个用于与 Apple Reminders 集成的 MCP 服务器,旨在通过标准化接口简化与 Apple Reminders 的交互。

核心功能

  • 列出所有提醒事项和提醒列表
  • 创建新的提醒事项,包括标题和可选详细信息
  • 标记提醒事项为完成/未完成
  • 为提醒事项添加备注
  • 设置提醒事项的截止日期
  • 原生 macOS 集成

适用场景

  • 个人日程管理
  • 工作任务跟踪
  • 购物清单管理
  • 家庭事务安排

工具列表

  1. Create Reminder: 创建新的提醒事项,支持标题、截止日期、列表和备注。
  2. List Reminders: 列出所有提醒事项或特定列表中的提醒事项,支持显示已完成事项。
  3. List Reminder Lists: 返回所有可用的提醒列表。

常见问题解答

  • Q: 是否需要 macOS 系统? A: 是的,该服务需要 macOS 系统以实现与 Apple Reminders 的原生集成。
  • Q: 如何验证服务是否正常运行? A: 可以通过创建或列出提醒事项来验证服务是否正常工作。

使用教程

使用依赖

  • Node.js 18 或更高版本
  • macOS(用于 Apple Reminders 集成)
  • Xcode Command Line Tools(用于编译 Swift 代码)

安装教程

  1. 通过 npm 全局安装:
npm install -g mcp-server-apple-reminders
  1. 配置 Cursor、ChatWise 或 Claude Desktop 以识别 Apple Reminders MCP 服务器。具体配置步骤请参考 README 中的详细说明。

调试方式

  1. 启动 MCP 服务器:
mcp-server-apple-reminders
  1. 使用以下命令测试功能:
# 创建提醒事项
mcp-server-apple-reminders create_reminder "Buy groceries" "2025-03-12 10:00:00" "Shopping" "Don't forget milk"

# 列出提醒事项
mcp-server-apple-reminders list_reminders "Shopping"

# 列出提醒列表
mcp-server-apple-reminders list_reminder_lists

许可证

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