使用说明
苹果提醒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为了消除歧义。