Skip to main content
Glama
apple-reminders-mcp-server

apple-reminders-mcp-server

by yzheeng

apple-reminders-mcp-server

一个基于 MCP(Model Context Protocol) 的 macOS 提醒事项工具服务。 通过 AppleScript 操作系统原生「提醒事项」,以标准 MCP 协议(stdio 传输)暴露增删改查工具, 可被任何 MCP 兼容的 Agent / Host 接入使用。

本项目从 calendar-agent 的内置工具层重构而来—— 将进程内硬编码的工具函数解耦为独立、可复用的 MCP Server。

提供的工具

工具

说明

create_reminder

创建提醒事项,支持指定截止时间

list_reminders

列出未完成提醒,支持按时间范围过滤

list_completed_reminders

列出已完成提醒,按完成时间范围过滤

update_reminder

修改指定提醒的标题或时间

complete_reminder

标记指定提醒为已完成

delete_reminder

删除指定提醒

Related MCP server: Apple Reminders MCP Server

环境要求

  • macOS(依赖系统「提醒事项」与 AppleScript)

  • Python 3.12+

  • uv

快速开始

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 tools
complete_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

    A4.1/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct action: create, list (incomplete), list completed, complete, update, delete. No overlapping functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_reminder, list_reminders, complete_reminder). No deviations.

    Tool Count5/5

    With 6 tools, the set covers the essential operations for reminders without bloat. It is well-scoped for the domain.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers