mcpField
A
Apple Reminders

Apple Reminders

本地服务
github.com生产力322 天前更新

关于 Apple Reminders

Apple Reminders 是面向 macOS 的 MCP 服务,通过 EventKit 管理提醒事项,适合需要让 Agent 读取和维护任务的工作流。它支持列表与提醒事项操作,并提供权限检查和规划提示词。

主要功能

  1. 01发现、创建和删除提醒列表
  2. 02列出、创建、更新和删除提醒
  3. 03完成或取消完成任务
  4. 04提供今日与列表资源
  5. 05检查健康状态和访问权限

适用场景

  1. 01让 Agent 整理待办和跟进事项
  2. 02在隔离于其他 Apple 服务的场景管理提醒
  3. 03检查提醒事项访问权限并排查问题

MCP 相关

该 MCP 服务向客户端提供提醒列表和任务相关工具、资源及提示词。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库
安装包
pypiapple-mcp-reminders1.1.4
mcpbapple-reminders-1.1.4.mcpb1.1.4

工具

17

收录的工具列表 · 更新于 1 天前

此工具无需参数。

详细介绍

Apple Reminders MCP

macOS 上用于 Apple Reminders 的 MCP 服务。

通过 EventKit 访问提醒事项列表和任务。在启用 Agent 读取、创建、更新、完成和删除提醒事项的同时,继续以 Reminders 作为事实来源。

适用场景

  • 任务和提醒事项工作流
  • 将 Reminders 与 Apple 生态的其他部分隔离
  • 基于 EventKit 的提醒事项管理

功能

  • 查找、创建和删除提醒事项列表
  • 列出、创建、更新和删除提醒事项
  • 完成和取消完成任务
  • 面向上下文受限客户端的工具发现辅助工具 search_tools 和 get_tool_info
  • 今天和列表资源
  • 规划和收件箱分类提示词
  • 健康状态和权限检查:reminders_health、reminders_permission_guide、reminders_recheck_permissions

在这台 Mac 上安装

快速开始(uvx,从 PyPI 安装)

安装好 uv 后:

uvx apple-mcp-reminders

无需克隆,也无需管理虚拟环境。

从克隆的仓库安装
git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

这会构建一个工作区环境,其中包含每个服务的入口点,位于 .venv/bin 中(例如 .venv/bin/apple-reminders-mcp)。你也可以让 MCP 客户端指向 AppleReminders-MCP/start.sh;该脚本优先使用 uv run,并在无法使用时回退到普通的 venv 引导流程(需要 Python 3.11+)。

在 AI Agent 中安装

通用 MCP 客户端配置
{
  "mcpServers": {
    "apple-reminders": {
      "command": "uvx",
      "args": ["apple-mcp-reminders"],
      "env": {
        "APPLE_REMINDERS_MCP_SAFETY_MODE": "safe_manage"
      }
    }
  }
}

如果是从克隆的仓库运行呢?将 /path/to/Apple-MCPs/AppleReminders-MCP/start.sh 设为命令,并使用空的 args。

Claude Code 示例
claude mcp add --transport stdio --scope user apple-reminders -- uvx apple-mcp-reminders

--scope user 会使所有项目都能使用该服务。若要通过仓库中的 .mcp.json 仅与一个仓库共享,请使用 --scope project。

安全模式

  • safe_readonly
  • safe_manage
  • full_access

传输方式

默认且推荐的传输方式是 stdio。设置 APPLE_REMINDERS_MCP_TRANSPORT=streamable-http(可选设置 APPLE_REMINDERS_MCP_HOST 和 APPLE_REMINDERS_MCP_PORT),即可改用 Streamable HTTP 提供服务。

macOS 权限

  • 必须授予 Reminders 访问权限

启动检查清单

  • 将 uvx apple-mcp-reminders(或克隆仓库中的 AppleReminders-MCP/start.sh)添加到 MCP 客户端
  • 重新加载或重新连接客户端,以便将 Reminders 工具集加载到上下文中
  • 首先调用 reminders_health
  • 如果 Reminders 访问权限被阻止,请调用 reminders_permission_guide
  • 更改 macOS 权限后,请调用 reminders_recheck_permissions

提示词编写说明

  • tools/list 会返回完整的 Reminders 工具集。上下文受限的客户端可以先使用 search_tools,再通过 get_tool_info 获取所需的 Reminders 工具信息。
  • Reminders 按列表组织。首次使用时,请查找可用列表并设置默认列表。
  • 使用 Reminders 管理有截止日期的事项、任务和后续跟进事项。
  • due_date 必须包含时区偏移:yyyy-MM-ddTHH:mm:ss-HH:00

相关项目

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。