Apple提醒事项连接服务

一个通过AppleScript将Claude Desktop与macOS上的Apple提醒事项连接的MCP服务器,提供创建、管理提醒事项的功能。

  • by kamrenkennedy
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 kamrenkennedy/apple-reminders-mcp

使用说明

苹果提醒mcp

一个MCP服务器,通过AppleScript将Claude Desktop连接到macOS上的Apple提醒。

先决条件

安装

1.添加到Claude桌面配置

打开 ~/Library/Application Support/Claude/claude_desktop_config.json 并添加:

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

2.重新启动克劳德桌面

首次使用提醒工具时,macOS会提示您授予提醒访问权限——单击“允许”。


手动安装(可选)

如果您更喜欢从源代码运行:

git clone https://github.com/kamrenkennedy/apple-reminders-mcp.git
cd apple-reminders-mcp
npm install

然后改用此配置:

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

工具

list_reminders

在所有列表或特定列表中列出提醒。

参数 类型 说明
list_name string 筛选到特定列表(可选)
include_completed boolean 包括已完成的提醒(默认值:false)

create_reminder

创建新的提醒。

参数 类型 说明
name 字符串 必修的。 提醒的标题
list_name string 目标列表(默认:提醒)--如果不存在则创建
due_date string 到期日期 YYYY-MM-DD 格式
due_time string 到期时间 HH:MM 24小时制--必填 due_date
priority 字符串 none / low / medium / high / urgent
notes string 正文/注释文本
tags string[] 要附加的标签

complete_reminder

将提醒标记为已完成。

参数 类型 说明
name 字符串 必修的。 提醒的确切名称
list_name string 将搜索范围缩小到此列表(可选)

delete_reminder

永久删除提醒。

参数 类型 说明
name 字符串 必修的。 提醒的确切名称
list_name string 将搜索范围缩小到此列表(可选)

update_reminder

更新现有提醒上的任何字段。仅更改提供的字段。 如果你更新 notes 或 tags 单独地,另一个被自动保存。

参数 类型 说明
name 字符串 必修的。 提醒的当前名称
list_name string 缩小搜索范围的当前列表
new_name string 重命名提醒
new_list_name string 将提醒移动到此列表
due_date string 中的新截止日期 YYYY-MM-DD 格式
due_time string 新的到期时间 HH:MM 24小时制
clear_due_date boolean 完全删除截止日期
priority 字符串 none / low / medium / high / urgent
notes string 替换注释文本
tags string[] 替换标签

备注

  • 标签 存储在提醒的备注字段中,如下所示 [tags: tag1, tag2] 因为本机提醒标签API不能通过AppleScript访问。他们通过所有工具正确地往返。
  • 提醒与确切名称相匹配。如果列表中有重复项,请传递 list_name 为了消除歧义。