Apple Reminders MCP server for Mac AI agents

Last updated: 2026-11-14

An AI agent cannot reach the Reminders app on your Mac by itself: it needs an MCP server that speaks to Reminders on its behalf. Emerald Tools is a menu bar app for macOS 14.0 or later that includes one. With its Reminders service on, a connected agent can list, read, create, update and complete your reminders, and you decide per tool whether each call runs silently, waits for your approval in a confirmation panel, or is refused. Agents are never given a way to delete a reminder.

An agent on its own

  • Reminders keeps its data in the system's store, which a chat or coding agent has no direct way into.
  • Asking the agent to "add this to my reminders" ends with text you copy across yourself.
  • Anything that does bridge the gap has to be trusted with everything it can reach, all at once.

The Reminders service in Emerald Tools

  • Gives a connected agent five tools for Reminders: list your lists, read, create or update, complete, and append a note.
  • Lets you set each tool to Always Allow, Ask or Deny. Reading defaults to Always Allow; anything that changes a reminder defaults to Ask.
  • Shows a confirmation panel on Ask, with the agent's name and the exact arguments, and cancels on its own after 30 seconds.
  • Offers no delete tool at all, and never recreates a reminder you deleted yourself.
  • Records which client completed a reminder, in a line added to its notes.
A 42-second screen recording: the MCP server is switched on in Emerald Tools and the tool permissions are set, then an agent in a code editor creates a reminder in a list called Sample Project, asks to append a note — Emerald Tools shows an Allow this action? panel, which is approved — and marks the reminder completed, while the Reminders app beside it updates.

How to connect an AI agent to Apple Reminders

  1. Choose what each Reminders tool may doSet up the MCP server and register it with your MCP client first, as described in the MCP server guide, and make sure Reminders is switched on under Tool Groups. Click the chevron next to Reminders to open its page, which lists its five tools. Every tool has a menu with three settings: Always Allow runs the call straight away, Ask shows a confirmation panel first, and Deny hides the tool from agents altogether.
    The Reminders page of the MCP Server tab, listing reminders_list_lists, reminders_query, reminders_upsert, reminders_complete and reminders_append_note, each with a permission menu showing Always Allow or Ask, and notes below explaining that agents can never delete reminders.
  2. Ask the agentAsk in plain words — add a reminder to a list, note something on one, tick one off. The first time an agent reaches for Reminders, macOS asks whether Emerald Tools may access your reminders; that permission is macOS's own, and you can withdraw it later in System Settings. From then on, a tool set to Ask brings up an Allow this action? panel naming the agent, the tool and the arguments it sent. Allow runs it; Don't Allow, or letting the countdown run out, sends the agent a refusal instead.
    An Emerald Tools panel titled Allow this action? in front of a code editor, saying claude-code (via Emerald Tools MCP) wants to use reminders_append_note, showing the arguments with a reminder id and the text Sample text, a countdown reading Cancels automatically in 29 seconds, and Don't Allow and Allow buttons.
  3. Check the result in RemindersChanges land in the Reminders app straight away, in the list the agent named — there is no separate list for agents. A reminder an agent completes also gets one line added to its notes, recording which client completed it and when, so a tick you did not make yourself can always be traced.
    A code editor where an agent has run reminders_upsert, reminders_append_note and reminders_complete, beside the Reminders app showing the Sample Project list with New task and Sample task, the latter carrying the note Sample text.

What an agent can do, and what it cannot

Turning on the MCP server, registering the connector, how permissions work and how the connection stays on your Mac are covered in the MCP server guide. This page is about the Reminders service.

The tools are few on purpose, and each one does a single thing.

Tool What it does Default
reminders_list_lists Lists your reminder lists, with their names Always Allow
reminders_query Reads reminders across lists; open ones by default, optionally completed ones and those due before a given time Always Allow
reminders_upsert Creates a reminder in a list you name, or updates the one it created earlier Ask
reminders_complete Marks one or more reminders completed Ask (its own panel)
reminders_append_note Adds a line to a reminder’s notes, never replacing what is there Ask

What is left out matters as much:

  • No deleting. Not for reminders, not for lists, and not as a setting you can turn on.
  • No overwriting notes. Notes only grow, one line at a time.
  • No resurrecting. An agent tracks each reminder it creates by a name of its own choosing, kept inside Emerald Tools rather than in your reminders. If you delete that reminder, the next attempt to update it is answered with “deleted by user” and nothing is recreated.
  • No new lists. Agents write into lists you already have, and every write has to say which one.

Completing reminders

Completing is handled slightly differently from the other tools. On Ask, instead of the general Allow this action? panel, Emerald Tools shows its own panel asking Complete this reminder? — or, for several, how many — and listing every reminder the agent wants to complete. Items you decline, or that time out, come back to the agent as cancelled.

A completed reminder gets a line appended to its notes in this form:

[Emerald Tools] Completed-By: <client> <version> (via Emerald Tools MCP) at <time>

The client’s name and version are what the client reported about itself. They tell you which tool was used, not who was at the keyboard.

Specifications and limits

  • Tools: five — list lists, query, create or update, complete, append a note.
  • Permissions: Always Allow, Ask or Deny for each tool; reading defaults to Always Allow, changing to Ask. The Reminders service can be switched off as a whole.
  • Deletion: not available to agents.
  • Completion record: one line appended to the notes of each reminder an agent completes.
  • Due dates: a date, or a date and time, in your local time.
  • Permissions from macOS: full access to Reminders, requested by macOS the first time an agent uses it.
  • System requirement: macOS 14.0 (Sonoma) or later, Emerald Tools 1.2 or later.

Emerald Tools is an independent app. It is not affiliated with, endorsed by or sponsored by Anthropic or Apple. The MCP server is a way for an AI client you already use to reach your reminders under rules you set; it does not provide an AI model of its own.

Frequently asked questions

Can an agent delete my reminders?

No. There is no delete tool to call, and no setting that adds one. An agent can mark a reminder completed, and a completion is an ordinary change you can undo in the Reminders app. If you delete a reminder an agent created, the agent cannot bring it back: a later attempt to update it reports that you deleted it rather than creating a new one.

Does it ask before every action?

Only for the tools you set to Ask. Out of the box, the two tools that read — listing your reminder lists and reading reminders — are set to Always Allow, and the three that change something — creating or updating, completing, and appending a note — are set to Ask. You can change any of them. Completing has its own panel that lists every reminder the agent wants to complete, and it is skipped only when you set that tool to Always Allow.

Where do agent-created reminders go?

Into the lists you already have. Emerald Tools does not create a list for agents, and every write names its target list, so an agent has to know which list it means — it can ask for the list of lists first. Reading covers every list.

Why does macOS ask about access to my reminders?

Emerald Tools reads and writes reminders through macOS's own Reminders access, which the system grants per app. It asks once, the first time an agent uses a Reminders tool, and you can turn it off again in System Settings under Privacy & Security. Without it, the Reminders tools cannot reach your reminders.

What do I need?

A Mac running macOS 14.0 (Sonoma) or later, Emerald Tools version 1.2 or later, and an MCP client on the same Mac. Emerald Tools is a subscription app with a 14-day free trial; the App Store listing shows the current terms for your region.

Get Emerald Tools for macOS

The MCP server is one part of Emerald Tools, alongside multi-display live wallpapers, system monitor widgets, screenshots that upload to Google Drive, a web media collector, and a WebP to MP4 converter. It lives in the menu bar and stays out of your Dock.

Download on the App Store