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 分