AI导哈

提醒事项服务

一个基于Swift和EventKit的Apple提醒事项服务器，提供创建、更新、删除和搜索提醒事项的功能。

  • by revenant20
  • Swift
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 revenant20/reminders-mcp

使用说明

提醒mcp

macOS上用于Apple提醒的MCP服务器。使用Swift和EventKit构建。

俄语文档

安装

需求

  • macOS 14（索诺玛）或更高版本
  • Swift 6.0+

构建

git clone https://github.com/revenant20/reminders-mcp.git
cd reminders-mcp
./build.sh

该脚本编译发布版本，并使用提醒访问所需的权限对二进制文件进行签名。输出： .build/release/reminders-mcp.

配置您的MCP客户端

将服务器添加到MCP客户端配置中。例如，对于Claude Desktop(claude_desktop_config.json):

{
  "mcpServers": {
    "reminders": {
      "command": "/absolute/path/to/reminders-mcp/.build/release/reminders-mcp"
    }
  }
}

首次启动时，macOS将请求访问提醒的权限——单击“允许”。

为什么选择此服务器

  • Swift原生二进制文件。 不需要Node.js、Python或任何其他运行时。单编译二进制文件——刚刚好用。
  • EventKit，而不是AppleScript。 通过苹果官方框架直接访问提醒数据库。比基于AppleScript的替代方案更快、更可靠。
  • 重量轻。 最小依赖性——只有 MCP Swift SDK没有繁重的框架或抽象层。
  • 正确签名。 构建脚本使用所需的权限对二进制文件进行签名，以便立即访问提醒。

工具

list_lists

获取所有提醒列表。

参数：无。

list_reminders

从特定列表中获取提醒。

参数 类型 必填 说明
list_name string yes 提醒列表的名称
filter string 否 incomplete （默认）， complete，或 all

create_reminder

创建新的提醒。

参数 类型 必填 说明
title string 是 提醒标题
notes string 否 提醒事项
list_name string no 列表名称（默认值：默认列表）
due_date string no ISO 8601中的到期日期(YYYY-MM-DD 或 YYYY-MM-DDTHH:MM:SS)
priority integer 否 优先级：0=无，1=高，5=中，9=低
tags string[] no 标签（无 #).作为标签附加到笔记中

update_reminder

更新现有提醒。只传递要更改的字段。

参数 类型 必填 说明
id string 是 提醒ID(calendarItemIdentifier)
title string 否 新标题
notes string no 新音符（清除空字符串）
due_date string no ISO 8601中的新截止日期（要删除的空字符串）
priority integer 否 优先级
list_name string 否 移动到其他列表
add_tags string[] no 要添加的标签（无 #).作为标签附加到笔记中
remove_tags string[] no 要删除的标签（无 #).从标题和注释中删除

complete_minder

将提醒标记为已完成或未完成。

参数 类型 必填 说明
id string 是 提醒ID
completed boolean 否 true 为了完成， false 未完成（默认值： true)

删除提醒器

永久删除提醒。

参数 类型 必填 说明
id string 是 提醒ID

搜索提醒器

在所有列表中按文本和/或标签搜索提醒。

参数 类型 必填 说明
query string no* 搜索文本（不区分大小写，匹配标题和注释）
tag string no* 按标签筛选（无 #)
include_completed boolean 否 包括已完成的提醒（默认值： false)

*至少 query 或 tag 必须提供。

标签

标签存储为标签(#work, #shopping)在提醒注释字段中，并由服务器解析：

  • 创建 提醒- tags 参数将标签附加到注释中
  • 更新 — add_tags 为笔记添加新标签， remove_tags 将它们从标题和注释中删除
  • 阅读 --the tags 响应中的字段包含标题和注释中的所有标记
  • 搜索 --the tag 参数按标签过滤提醒

注： 这些是 不 本地提醒标签。Apple不会在EventKit API或AppleScript字典中公开标记管理。本地标签（在提醒侧栏中可见的彩色标签）只能通过提醒UI分配。此服务器创建的标签是notes字段中的标签字符串——它们用于通过MCP服务器进行搜索和过滤，但不会在提醒应用程序中显示为本地标签。

已知限制

  • 标签不是原生的。 EventKit没有用于本机提醒标签的API。标签存储为 #hashtag 注释中的文本——完全适用于基于MCP的搜索和过滤，但对提醒应用程序标签系统不可见。请参阅 标签 详情请参阅第节。
  • 不支持列表中的部分。 苹果从macOS Sonoma开始在提醒用户界面中引入了部分，但尚未在公共EventKit API中公开。等待Apple添加此内容。

测试

swift test

相关 MCP