苹果提醒服务

一个用于与macOS上的Apple Reminders应用交互的MCP服务器,提供列表管理、提醒创建、完成和删除等功能。

  • by shadowfax92
  • TypeScript
  • 本地部署
  • 39 星标
  • 更新于
在 GitHub 查看 shadowfax92/apple-reminders-mcp

使用说明

MCP苹果提醒

用于在macOS上与Apple提醒进行交互的模型上下文协议(MCP)服务器。

特性

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

配置

使用Claude Desktop

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "apple-reminders": {
      "command": "node",
      "args": [
        "/path/to/mcp-apple-reminders/dist/index.js"
      ]
    }
  }
}

NPX(即将推出)

{
  "mcpServers": {
    "apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-apple-reminders"
      ]
    }
  }
}

API

服务器公开了以下MCP工具,用于与Apple提醒进行交互:

getLists

返回所有提醒列表。

获取提醒

从特定列表中返回提醒。

  • 参数:
    • listName (必填):提醒列表的名称

创建提醒

创建新的提醒。

  • 参数:
    • listName (必填):提醒列表的名称
    • title (必填):提醒的标题
    • dueDate (可选):提醒的截止日期(ISO格式:“YYYY-MM-DDTHH:MM:SS.sssZ”)
    • notes (可选):提醒注意事项

complete提醒

将提醒标记为已完成。

  • 参数:
    • listName (必填):提醒列表的名称
    • reminderName (必填):提醒完成的名称

删除提醒

删除提醒。

  • 参数:
    • listName (必填):提醒列表的名称
    • reminderName (必填):要删除的提醒的名称

运作原理

此MCP服务器使用AppleScript与macOS上的Apple提醒应用程序进行交互。它为AI助手提供了一个标准化的界面,通过模型上下文协议管理提醒。

发展

该项目使用TypeScript和MCP SDK。要扩展功能,请修改中的工具 src/index.ts AppleScript函数在 src/reminders.ts.

需求

  • macOS(集成Apple提醒程序所需)
  • Node.js 16+
  • Apple提醒应用程序配置了至少一个列表

许可证

麻省理工学院