MCP Apple Reminders

MCP Apple Reminders

site icon
2025.03.08 2
TypeScript日程管理日程管理
apple-reminders-mcp 是一个基于 Model Context Protocol (MCP) 的服务,专门用于与 macOS 上的 Apple Reminders(提醒事项)应用进行交互。它提供了一系列功能,包括管理提醒列表、创建和完成提醒事项等,旨在为 AI 助手提供一个标准化的接口来管理用户的提醒事项。
View on GitHub

Overview

基本能力

产品定位

apple-reminders-mcp 是一个专门用于与 macOS 上的 Apple Reminders 应用进行交互的 MCP 服务,旨在通过标准化的接口帮助用户管理提醒事项。

核心功能

  • 列表管理:查看 Apple Reminders 应用中的所有提醒列表
  • 提醒检索:从特定列表中获取所有提醒
  • 创建提醒:创建带有标题、截止日期和备注的新提醒
  • 完成提醒:将提醒标记为已完成
  • 删除提醒:从列表中删除提醒
  • 日期处理:正确处理截止日期的 ISO 格式

适用场景

  • 个人日程管理
  • 任务提醒设置
  • 自动化任务管理

工具列表

  • getLists:返回所有提醒列表
  • getReminders:返回特定列表中的提醒
  • createReminder:创建新提醒
  • completeReminder:标记提醒为已完成
  • deleteReminder:删除提醒

常见问题解答

  • 系统要求:需要 macOS 和 Node.js 16+,以及配置好的 Apple Reminders 应用
  • 开发扩展:使用 TypeScript 和 MCP SDK 进行功能扩展

使用教程

使用依赖

  • macOS 系统
  • Node.js 16+
  • Apple Reminders 应用(至少配置一个列表)

安装教程

  1. 使用 Claude Desktop 配置:
{
  "mcpServers": {
    "apple-reminders": {
      "command": "node",
      "args": [
        "/path/to/mcp-apple-reminders/dist/index.js"
      ]
    }
  }
}
  1. 或使用 NPX(即将推出):
{
  "mcpServers": {
    "apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-apple-reminders"
      ]
    }
  }
}

调试方式

  • 确保 Apple Reminders 应用已正确配置
  • 检查 Node.js 版本是否符合要求
  • 验证 MCP 服务器配置是否正确

许可证

该项目遵循 MIT 开源许可条款。