Apple Reminders

io.github.JonathanRReedPublished by GitHub account JonathanRReedv1.1.6Updated Nov 7, 2026

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

Overview

AI-generated overview

Local macOS MCP server that lets an assistant read, create, update, complete and delete Apple Reminders lists and tasks through EventKit.

What you can do
  • List, create and delete reminder lists
  • List and fetch reminders with optional list and due-date filters
  • Create, update, complete, uncomplete and delete reminders
  • Check server health and macOS Reminders permission status, with a permission guide and recheck
  • Search the server's own tool catalog and load a tool's full schema
When to use it
Useful when you want an assistant to manage tasks in Apple Reminders on a Mac: reviewing upcoming or due items, triaging an inbox list, creating follow-ups, or marking tasks done, while Reminders stays the system of record.
Requirements
Runs locally on macOS only, as a stdio process started with uvx from the PyPI package (Python 3.11+ for the clone/start script route). macOS Reminders permission must be granted. Optional environment variables APPLE_REMINDERS_MCP_SAFETY_MODE and APPLE_REMINDERS_MCP_ALLOWED_LISTS control write scope; no accounts or API keys.
Before you install
The server can create, update, complete and delete reminders and delete entire lists, which is destructive and hard to undo. Set APPLE_REMINDERS_MCP_SAFETY_MODE to safe_readonly or safe_manage rather than full_access unless deletion is intended, and use APPLE_REMINDERS_MCP_ALLOWED_LISTS to limit which lists are reachable. It reads and writes your personal Reminders data on the machine.

Installation

In SourceWeft

  1. Open Apple Reminders in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: AppleReminders-MCP/README.md at commit 9aeaa81

Tools

17

reminders_health

Reminders Health

Report the active Apple Reminders MCP server configuration.

Takes no parameters.

reminders_permission_guide

Reminders Permission Guide

Explain how to grant Apple Reminders permission on macOS.

Takes no parameters.

reminders_recheck_permissions

Reminders Recheck Permissions

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

Takes no parameters.

reminders_list_lists

List Reminder Lists

List available Apple Reminders lists.

Takes no parameters.

reminders_create_list

Create Reminder List

Create a new Apple Reminders list.

Parameterstitlerequired

reminders_delete_list

Delete Reminder List

Delete a reminder list entirely. Requires full_access safety mode.

Parameterslist_idrequired

reminders_list_reminders

List Reminders

List reminders with optional list and due-date filters.

Parameterslimitsearchlist_iddue_afterdue_beforeinclude_completed

reminders_get_reminder

Get Reminder

Fetch full details for a reminder by reminder_id.

Parametersreminder_idrequired

reminders_create_reminder

Create Reminder

Create a new reminder in a specific Apple Reminders list.

Parameterstagsnotestitlerequiredlist_idrequireddue_datepriorityremind_atdue_all_dayparent_reminder_id

reminders_update_reminder

Update Reminder

Update one or more fields on an existing reminder.

Parameterstagsnotestitlelist_iddue_datepriorityremind_atdue_all_dayreminder_idrequiredparent_reminder_id

reminders_complete_reminder

Complete Reminder

Mark a reminder as completed.

Parametersreminder_idrequired

reminders_uncomplete_reminder

Uncomplete Reminder

Mark a reminder as not completed.

Parametersreminder_idrequired

reminders_delete_reminder

Delete Reminder

Delete a reminder by reminder_id.

Parametersreminder_idrequired

reminders_list_prompts

Reminders List Prompts

Fallback prompt discovery tool for tool-only MCP clients.

Takes no parameters.

reminders_get_prompt

Reminders Get Prompt

Fallback prompt rendering tool for tool-only MCP clients.

Parametersnamerequiredarguments_json

search_tools

Search Tools

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

Parametersmodelimitqueryrequireddomain_tags

get_tool_info

Get Tool Info

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

Parametersnamerequiredinclude_schemainclude_examples

Version history

8
  1. v1.1.6LatestNov 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

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts