# remi [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/mattheworiordan/remi  
**GitHub Stars:** 25  
**npm Downloads (last month):** 147  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/remi

## Description
Apple Reminders CLI and MCP server with section support and iCloud sync

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "remi": {
    "command": "npx",
    "args": ["-y","@mattheworiordan/remi"]
  }
}
```

## Documentation

## 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:

```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`:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/remi/readme_