Apple Reminders

io.github.JonathanRReed由 GitHub 账号 JonathanRReed 发布v1.1.6更新于 Nov 7, 2026

List, create, update, complete, and delete reminders in Apple Reminders on macOS.

已验证STDIO仅桌面效率与工作流文件与存储

概览

AI 生成的概览

本地 macOS MCP 服务器，让助手通过 EventKit 读取、创建、更新、完成和删除 Apple 提醒事项的列表与任务。

可以做什么
  • 列出、创建和删除提醒事项列表
  • 按列表和到期日筛选列出提醒事项并查看详情
  • 创建、更新、完成、取消完成和删除提醒事项
  • 检查服务器健康状态与 macOS 提醒事项权限，并提供授权指引和重新检查
  • 搜索本服务器的工具目录并加载单个工具的完整结构
适用场景
适合在 Mac 上让助手管理 Apple 提醒事项中的任务：查看即将到期或待办事项、整理收件箱列表、创建后续任务或标记完成，同时仍以提醒事项作为记录来源。
运行要求
仅在 macOS 上本地运行，通过 uvx 从 PyPI 包以 stdio 方式启动（使用克隆仓库的启动脚本需 Python 3.11 及以上）。需要授予 macOS 提醒事项访问权限。可选环境变量 APPLE_REMINDERS_MCP_SAFETY_MODE 和 APPLE_REMINDERS_MCP_ALLOWED_LISTS 控制写入范围；无需账号或 API 密钥。
安装前请注意
该服务器可创建、更新、完成和删除提醒事项，甚至删除整个列表，属于破坏性操作且难以撤销。除非确实需要删除，建议将 APPLE_REMINDERS_MCP_SAFETY_MODE 设为 safe_readonly 或 safe_manage，并用 APPLE_REMINDERS_MCP_ALLOWED_LISTS 限制可访问的列表。它会读写本机上的个人提醒事项数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Apple Reminders，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Apple Reminders MCP

MCP server for Apple Reminders on macOS.

Provides access to reminder lists and tasks through EventKit. Keep Reminders as the system of record while enabling agents to read, create, update, complete, and delete reminders.

When to use

  • Task and reminder workflows
  • Reminders isolated from the rest of the Apple stack
  • EventKit-backed reminder management

What It Does

  • Discover, create, and delete reminder lists
  • List, create, update, and delete reminders
  • Complete and uncomplete tasks
  • Tool discovery helpers search_tools and get_tool_info for context-constrained clients
  • Today and list resources
  • Planning and inbox-triage prompts
  • Health and permission checks: reminders_health, reminders_permission_guide, reminders_recheck_permissions

Install On This Mac

Quick start (uvx, from PyPI)

With uv installed:

bash
uvx apple-mcp-reminders

No clone, no venv management.

From a clone
bash
git clone https://github.com/JonathanRReed/Apple-MCPs.gitcd Apple-MCPsuv sync --all-packages

This builds one workspace environment with every server's entry point in .venv/bin (for example .venv/bin/apple-reminders-mcp). You can also point an MCP client at AppleReminders-MCP/start.sh, which prefers uv run and falls back to a plain venv bootstrap (Python 3.11+ required).

Install In AI Agents

Generic MCP client config
json
{  "mcpServers": {    "apple-reminders": {      "command": "uvx",      "args": ["apple-mcp-reminders"],      "env": {        "APPLE_REMINDERS_MCP_SAFETY_MODE": "safe_manage"      }    }  }}

Running from a clone instead? Use /path/to/Apple-MCPs/AppleReminders-MCP/start.sh as the command with empty args.

Claude Code example
bash
claude mcp add --transport stdio --scope user apple-reminders -- uvx apple-mcp-reminders

--scope user makes the server available in every project. To share it with one repository through its .mcp.json instead, use --scope project.

Safety Modes

  • safe_readonly
  • safe_manage
  • full_access

Transport

stdio is the default and recommended transport. Set APPLE_REMINDERS_MCP_TRANSPORT=streamable-http (with optional APPLE_REMINDERS_MCP_HOST and APPLE_REMINDERS_MCP_PORT) to serve Streamable HTTP instead.

macOS Permissions

  • Reminders access is required

Launch Checklist

  • Add uvx apple-mcp-reminders (or a clone's AppleReminders-MCP/start.sh) to your MCP client
  • Reload or reconnect the client so the Reminders tool surface is loaded into context
  • Call reminders_health first
  • If Reminders access is blocked, call reminders_permission_guide
  • After changing macOS permissions, call reminders_recheck_permissions

Prompting Notes

  • tools/list returns the full Reminders tool surface. Context-constrained clients can use search_tools first, then get_tool_info for the Reminders tool they need.
  • Reminders are organized into lists. Identify available lists on first use and set a default.
  • Use Reminders for due items, tasks, and follow-ups.
  • due_date requires a timezone offset: yyyy-MM-ddTHH:mm:ss-HH:00

Related

来源：AppleReminders-MCP/README.md，提交 9aeaa81

工具

17

reminders_health

Reminders Health

Report the active Apple Reminders MCP server configuration.

无需输入参数。

reminders_permission_guide

Reminders Permission Guide

Explain how to grant Apple Reminders permission on macOS.

无需输入参数。

reminders_recheck_permissions

Reminders Recheck Permissions

Recheck Reminders access after the user changes macOS permissions, and notify the client that Reminders resources changed.

无需输入参数。

reminders_list_lists

List Reminder Lists

List available Apple Reminders lists.

无需输入参数。

reminders_create_list

Create Reminder List

Create a new Apple Reminders list.

输入参数title必填

reminders_delete_list

Delete Reminder List

Delete a reminder list entirely. Requires full_access safety mode.

输入参数list_id必填

reminders_list_reminders

List Reminders

List reminders with optional list and due-date filters.

输入参数limitsearchlist_iddue_afterdue_beforeinclude_completed

reminders_get_reminder

Get Reminder

Fetch full details for a reminder by reminder_id.

输入参数reminder_id必填

reminders_create_reminder

Create Reminder

Create a new reminder in a specific Apple Reminders list.

输入参数tagsnotestitle必填list_id必填due_datepriorityremind_atdue_all_dayparent_reminder_id

reminders_update_reminder

Update Reminder

Update one or more fields on an existing reminder.

输入参数tagsnotestitlelist_iddue_datepriorityremind_atdue_all_dayreminder_id必填parent_reminder_id

reminders_complete_reminder

Complete Reminder

Mark a reminder as completed.

输入参数reminder_id必填

reminders_uncomplete_reminder

Uncomplete Reminder

Mark a reminder as not completed.

输入参数reminder_id必填

reminders_delete_reminder

Delete Reminder

Delete a reminder by reminder_id.

输入参数reminder_id必填

reminders_list_prompts

Reminders List Prompts

Fallback prompt discovery tool for tool-only MCP clients.

无需输入参数。

reminders_get_prompt

Reminders Get Prompt

Fallback prompt rendering tool for tool-only MCP clients.

输入参数name必填arguments_json

search_tools

Search Tools

Search this server's tool catalog by keyword, alias, or domain tag.

输入参数modelimitquery必填domain_tags

get_tool_info

Get Tool Info

Load the full schema, examples, and metadata for one tool from this server.

输入参数name必填include_schemainclude_examples

版本历史

8
  1. v1.1.6最新Nov 6, 2026
  2. v1.1.4Oct 29, 2026
  3. v1.1.3Oct 22, 2026
  4. v1.1.2Oct 14, 2026
  5. v1.1.1Oct 13, 2026
  6. v1.1.0Oct 10, 2026
  7. v1.0.5Sep 26, 2026
  8. v1.0.4Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分