remi

The CLI that Apple should have built for Reminders.

Create lists, add reminders, organize them into sections, and have everything sync across all your Apple devices — from the terminal.

- Sections with iCloud sync— the only CLI that supports Apple Reminders sections. Create them, assign reminders, move between them, and it all syncs.
- Natural language—--due "next tuesday",--repeat "every 2 weeks on monday,friday"
- Fuzzy matching— typeremi list shoppinginstead ofremi list "Groceries / Shopping List"
- Agent-first— structured JSON output, Claude Code plugin, skills.sh skill, OpenClaw compatible
- Fast— compiled Swift helpers, no Electron, no GUI

brew tap mattheworiordan/tap && brew install remi

npm install -g @mattheworiordan/remi # or run without installing npx @mattheworiordan/remi lists

remi lists # See all lists remi list "Groceries" # View a list (fuzzy: remi list groceries) remi add "Groceries" "Buy milk" --section "Dairy" # Add to a section remi today # What's due today? remi complete "Groceries" "milk" # Fuzzy complete

remi today # Due today remi overdue # Past due remi upcoming --days 7 # Coming up remi search "dentist" # Search across all lists

remi add "Work" "Review PR" --due "next friday" --priority high remi add "Work" "Standup" --due tomorrow --repeat daily remi complete "Work" "standup" remi update "Work" "Review PR" --due "in 3 days" remi delete "Work" "Review PR" --confirm

Dates:tomorrow,next tuesday,in 3 days, orYYYY-MM-DDRecurrence:daily,weekly,monthly,every 2 weeks,every 3 months on monday,friday

remi sections "Groceries" # List sections remi create-section "Groceries" "Produce" # Create a section remi add "Groceries" "Bananas" --section "Produce" # Add to a section remi move "Groceries" "Bananas" --to-section "Dairy" # Move between sections

Sections sync to iCloud via CRDT vector clocks. Seehow it works.

remi today --json # {"success": true, "data": [...]}

remi is designed for AI agents. Use it as an MCP server, Claude Code plugin, or skill:

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

16 tools:remi_lists,remi_add,remi_complete,remi_move,remi_today,remi_search, and more — all with fuzzy matching and structured responses.

# Claude Code plugin claude plugin marketplace add mattheworiordan/remi # skills.sh npx skills add mattheworiordan/remi # OpenClaw clawhub install remi

On first run, macOS will ask you to grant Reminders access (click Allow). Section features also need Full Disk Access for your terminal app.

remi authorize # Guides you through both remi doctor # Shows what's granted

- macOS 13+ (Ventura or later)
- Node.js 18+
- Xcode Command Line Tools (xcode-select --install)

remi uses three layers because Apple never exposed sections in their public API:

Thefull reverse-engineering storyexplains what we discovered about Apple's undocumented sync architecture.

git clone https://github.com/mattheworiordan/remi.git && cd remi npm install && npm run build:swift && npm run build npm test # Unit tests npm run test:integration # Integration tests (needs Reminders access)

Remote MCP server for MindMeister. Create, edit, and organize mind maps from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.mindmeister.com/mcp