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:

uvx apple-mcp-reminders

No clone, no venv management.

From a clone 
git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv 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 
{
  "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 
claude mcp add --transport stdio --scope project apple-reminders -- uvx apple-mcp-reminders

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

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for JonathanRReed from gravatar.com JonathanRReed

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

mcp model-context-protocol macos apple ai-agent automation

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apple_mcp_reminders-1.0.1.tar.gz (20.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

apple_mcp_reminders-1.0.1-py3-none-any.whl (21.3 kB view details)

Uploaded Python 3

File details

Details for the file apple_mcp_reminders-1.0.1.tar.gz.

File metadata

  • Download URL: apple_mcp_reminders-1.0.1.tar.gz
  • Upload date:
  • Size: 20.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for apple_mcp_reminders-1.0.1.tar.gz
Algorithm Hash digest
SHA256 5bcf0a0cbad781543825051168c06ba07617183ad0b114782434572bd52e97ed
MD5 fb0ea93d1e3df6fcdf6cfc8b72ae1c2f
BLAKE2b-256 3d3f0fb6ec006448fbf3d5089b41b05944c3e0ae4c070de2cc39e0352e416d4f

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_mcp_reminders-1.0.1.tar.gz:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file apple_mcp_reminders-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for apple_mcp_reminders-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1275a197302696004f9dfb2d7d62f427df6b7ddbd5a0b6efd2a2d8741200d0ae
MD5 5c2e047cb504d65c3c3bf80b3ff1ecb0
BLAKE2b-256 a6326593087bf3f3d583255243e5297b65a84e92c4db2f7979c08c0c125d4acb

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_mcp_reminders-1.0.1-py3-none-any.whl:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page