Remi logo

Remi

Connects AI agents to Apple Reminders for list, reminder, section, scheduling, and search operations through MCP.

Install Remi

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "remi": {
      "command": "npx",
      "args": [
        "-y",
        "@mattheworiordan/remi"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command installed and started the server, which then stopped for configuration (such as an API key) that our sandbox does not have — expected for servers that connect to your account.

npx -y @mattheworiordan/remi

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 3d ago.

Overview

Apple Reminders automation is available through the remi MCP server, which exposes reminder and list operations to AI agents. It runs the local `remi --mcp` command and returns structured responses for 16 tools, including list, add, complete, move, today, and search operations. Reach for it when an agent needs to read or modify Reminders on macOS, including lists organized with sections. It requires macOS 13 or later and Reminders permissions, with Full Disk Access needed for section features.

Use cases

  • Read today’s and overdue reminders
  • Add reminders to named lists and sections
  • Update due dates, priorities, and recurrence
  • Search reminders across Apple Reminders lists
  • Move reminders between sections

Key features

  • Apple Reminders list and reminder operations
  • Section creation and membership management
  • Natural-language dates and recurrence
  • Fuzzy list and reminder matching
  • Structured MCP responses
  • iCloud section synchronization

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

4/4 checks healthy over the last 13d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · @mattheworiordan/remi (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars25Stargazers on the source repository.
npm downloads147Package downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Install checkRunsOur sandbox started it; it then asked for an API key or config.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Remi works

What the remi MCP server does

The remi MCP server connects an MCP-compatible agent to Apple Reminders on macOS. It exposes operations for viewing lists, adding and updating reminders, completing or deleting items, checking due and overdue work, searching across lists, and managing sections. The underlying CLI also supports fuzzy matching, so an agent can identify a list or reminder without reproducing its full name.

Reminders can include due dates, priorities, and recurrence rules. Supported date inputs include phrases such as “tomorrow,” “next Tuesday,” and “in 3 days,” as well as YYYY-MM-DD dates. Recurrence examples include daily schedules, weekly or monthly repetition, and intervals such as every two weeks on selected weekdays.

How it works

Configure an MCP client to launch remi with the --mcp argument:

config.json
{
  "mcpServers": {
    "remi": {
      "command": "remi",
      "args": ["--mcp"]
    }
  }
}

The remi MCP server uses the same local Apple Reminders access as its command-line interface. Its implementation combines EventKit for reminder operations, ReminderKit for section operations, and SQLite plus token maps for section membership. Section synchronization uses CRDT vector clocks so section data can sync through iCloud.

The project documents 16 MCP tools. Responses are structured for agent use.

Setup and configuration

Install the CLI with Homebrew:

bash
brew tap mattheworiordan/tap && brew install remi

Alternatively, install the npm package globally or run it with npx:

Terminal
npm install -g @mattheworiordan/remi
npx @mattheworiordan/remi lists

The remi MCP server requires macOS 13 or newer, Node.js 18 or newer, and Xcode Command Line Tools. On first use, macOS asks for Reminders access. Section functionality additionally requires Full Disk Access for the terminal application. Run remi authorize for permission guidance or remi doctor to inspect the current grants.

The repository also lists Claude Code plugin, skills.sh, and OpenClaw usage paths, but those are separate from the MCP configuration. No environment variables are documented for running the MCP server.

Limitations and notes

This server is tied to Apple Reminders and therefore requires macOS. It is not a remote, platform-neutral reminders service. Standard reminder operations use Apple’s public EventKit API, while section support depends on private framework access and direct database writes. That implementation detail makes permissions especially important for agents that need to create, move, or synchronize sections.

The MCP setup launches a local process, so the configured client must be able to run the remi executable. The project is licensed under MIT.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Remi

remi is an MCP server that connects AI agents to Apple Reminders on macOS. Its main tools manage lists and reminders, including adding, completing, moving, searching, and checking due items. It also exposes section-related operations and returns structured responses for agent workflows.

Install it with Homebrew using `brew tap mattheworiordan/tap && brew install remi`, or install `@mattheworiordan/remi` globally with npm. You can also run it with `npx`; macOS 13+, Node.js 18+, and Xcode Command Line Tools are required.

Configure the client to launch `remi` with the `--mcp` argument. The server entry uses `"command": "remi"` and `"args": ["--mcp"]`; the client must be able to run the locally installed executable.

Yes, remi supports Claude Code through a separate plugin path, and it can also be configured as an MCP server using the standard `remi --mcp` command. The README provides a Claude Code marketplace command in addition to the MCP configuration.

Full Disk Access is needed for remi’s section features. Standard Reminders access is requested separately by macOS, while `remi authorize` guides both permission steps and `remi doctor` reports their status.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRemi AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/remi?style=directory)](https://allmcps.com/mcp/remi)
HTML Embed
<a href="https://allmcps.com/mcp/remi"><img src="https://allmcps.com/api/badge/remi?style=directory" alt="Remi on AllMCPs" /></a>