apple-reminders-mcp-server
Provides tools to manage Apple Reminders (the reminders app on macOS) including creating, listing, updating, completing, and deleting reminders.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@apple-reminders-mcp-server create a reminder to submit report by Friday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
apple-reminders-mcp-server
一个基于 MCP(Model Context Protocol) 的 macOS 提醒事项工具服务。 通过 AppleScript 操作系统原生「提醒事项」,以标准 MCP 协议(stdio 传输)暴露增删改查工具, 可被任何 MCP 兼容的 Agent / Host 接入使用。
本项目从 calendar-agent 的内置工具层重构而来—— 将进程内硬编码的工具函数解耦为独立、可复用的 MCP Server。
提供的工具
工具 | 说明 |
| 创建提醒事项,支持指定截止时间 |
| 列出未完成提醒,支持按时间范围过滤 |
| 列出已完成提醒,按完成时间范围过滤 |
| 修改指定提醒的标题或时间 |
| 标记指定提醒为已完成 |
| 删除指定提醒 |
Related MCP server: Apple Reminders MCP Server
环境要求
macOS(依赖系统「提醒事项」与 AppleScript)
Python 3.12+
快速开始
git clone https://github.com/yzheeng/apple-reminders-mcp-server
cd apple-reminders-mcp-server
uv sync
uv run apple-reminders-mcp-server首次调用工具时,macOS 会弹窗请求「自动化」权限(控制提醒事项),允许即可。
在 MCP Host 中接入
在你的 Host 配置中按如下方式声明(以通用 JSON 配置为例):
{
"mcpServers": {
"reminders": {
"command": "uv",
"args": ["--directory", "/path/to/reminder-mcp-server", "run", "reminder-mcp-server"]
}
}
}协议说明
传输方式:stdio(JSON-RPC 2.0,行分帧)
Available Tools
6 toolscomplete_reminderA
标记指定 id 的提醒事项为已完成。
Args: reminder_id: 提醒事项的 id(先用 list_reminders 查到)
Inputs: reminder_id (required).
create_reminderB
创建一条提醒事项。
Args: title: 提醒的标题 due: 截止时间,格式 2026-06-04 18:00,可选
Inputs: title (required), due.
delete_reminderA
删除指定 id 的提醒事项。
Args: reminder_id: 提醒事项的 id(先用 list_reminders 查到)
Inputs: reminder_id (required).
list_completed_remindersA
查询「已完成」的提醒事项。当用户想统计/回顾过去做了什么时用它 (例如「过去一周我完成了几场面试」)。按「完成时间」过滤,不是截止时间。
Args: start: 完成时间范围起点,格式 YYYY-MM-DD HH:MM,可选。例如「过去一周」 用 7 天前的 00:00。建议总是传一个起点,避免一次拉回过多历史。 end: 完成时间范围终点,格式 YYYY-MM-DD HH:MM,可选。例如「过去一周」 用今天 23:59。
Inputs: end, start.
list_remindersA
当用户想查看、修改、删除或完成提醒前,用它列出当前未完成提醒及其 id。 用户提到时间范围时通过 start/end 参数缩小范围。
Args: start: 时间范围起点,格式 YYYY-MM-DD HH:MM,可选。例如「今天」用今天 00:00, 「本周」用本周一 00:00。仅在用户提到时间范围时传入。 end: 时间范围终点,格式 YYYY-MM-DD HH:MM,可选。例如「今天」用今天 23:59, 「未来三天」用第三天的 23:59。 include_undated: 是否一并返回没有截止时间的提醒,默认 False; 仅在传了 start 或 end 时生效。
Inputs: end, start, include_undated.
update_reminderA
修改指定 id 的提醒事项的标题或截止时间。
Args: reminder_id: 提醒事项的 id(先用 list_reminders 查到) new_title: 新标题,可选 new_due: 新截止时间,格式 2026-06-04 18:00,可选
Inputs: reminder_id (required), new_due, new_title.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct action: create, list (incomplete), list completed, complete, update, delete. No overlapping functionality.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_reminder, list_reminders, complete_reminder). No deviations.
With 6 tools, the set covers the essential operations for reminders without bloat. It is well-scoped for the domain.
Covers full CRUD plus listing completed reminders. Missing a dedicated 'get' for a single reminder by ID, but list_reminders can serve that purpose. Minor gap.
Maintenance
Related MCP Connectors
MCP connector for Apple Reminders — search, create, complete, and edit via your own Mac.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA macOS-only MCP server that exposes Apple Reminders to AI clients, enabling create, read, update, delete, search, and organization of reminders and lists through natural language.3MIT
- AlicenseNot gradedqualityDmaintenanceMCP server enabling AI assistants to create, read, list, and delete Apple Reminders on macOS via AppleScript.26 PyPI11Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server for Apple Reminders, enabling management of reminders and lists via tools like add, edit, complete, and delete reminders.MIT
- AlicenseAqualityDmaintenanceAn MCP server that connects Claude Desktop to Apple Reminders on macOS via AppleScript.57 npmMIT