RemCTL CLI
Agents read and complete your reminders on a Mac, and in Claude Code a band above the prompt shows what is due today
- 657 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The app gets Full Disk Access plus Reminders and Automation access on macOS
- Through MCP an AI can create, edit and delete your reminders and lists
Install
- Works in
Manual install
/plugin marketplace add viticci/remctlAdds the marketplace. Then `/plugin install remctl@remctl` and `/reload-plugins`.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The app gets Full Disk Access plus Reminders and Automation access on macOS
- Through MCP an AI can create, edit and delete your reminders and lists
This is third-party code. Review the repository files before installing.
What it does
RemCTL is a CLI and MCP server for Apple Reminders on macOS. The commands `remctl today`, `remctl upcoming 7`, `remctl search "invoice" --json`, `remctl add "Review PR" -l Work -d "tomorrow 10:00" -p high` and `remctl done 23880` read, create and complete reminders. Every reminder has a stable numeric id, and every read command accepts `--json`. macOS permissions go to one small signed app, RemCTL Capability Host, which the terminal, scripts and AI apps share. RemCTL connects to AI apps with `remctl mcp install`, which also installs the server into Claude Desktop (`--client claude-desktop`) or packs it as an extension with `remctl mcp bundle`. The AI can read, create, edit, complete and delete reminders and lists, search with paging and restore from Recently Deleted. The Claude Code plugin installs from the `viticci/remctl` marketplace and adds the tools, a Today band above the prompt, a `/reminders` pane and a status line summary. For Codex on Mac there is a plugin with a Reminders workspace.
Who it is for. Mac users who keep their tasks in Apple Reminders and want Claude Code, Codex or Claude Desktop to see and complete them.
Good fit when
- You want to ask Claude Code what is planned for today and what is overdue without leaving the terminal
- Tasks from a conversation with an agent need to go to the Work list with a date and priority
- A reminders summary is needed as JSON for a script or automation
- A band with the remaining tasks and their times should sit above the Claude Code prompt
- An accidentally deleted reminder has to be restored through an MCP tool
Not a fit when
- You are not on macOS 14 or later: the tool works only with Apple Reminders and iCloud Reminders
- You need sync with Todoist, Notion or Google Tasks: RemCTL works only with the Reminders app
- Full Disk Access cannot be granted: it is one of the required permissions
Example request
Show my reminders for today and overdue ones, then add a Review PR task to the Work list for tomorrow at 10:00 with high priorityLimitations
RemCTL requires macOS 14 or later and iCloud Reminders turned on. The prebuilt `RemCTL-arm64.dmg` targets Apple silicon, while Intel needs a source build with `./install.sh --from-source --bootstrap` and the Command Line Tools. The app needs three permissions: Reminders, Automation for Reminders and Full Disk Access. The Claude Code mods (the Today band and `/reminders`) need version 2.1.287 or later, and older versions get only the tools. Switching between the downloaded and a self-built version changes the signature and requires granting permissions again.
How to disable. To remove it run `./uninstall.sh` from the repository folder, adding `--keep-config` to keep settings. `/plugin uninstall remctl@remctl` removes the Claude Code plugin, and the MCP connection is removed in the AI app settings.
FAQ
How do I install RemCTL in Claude Code?
Install RemCTL first (the DMG from Releases or `./install.sh --from-source --bootstrap`), then run `/plugin marketplace add viticci/remctl` and `/plugin install remctl@remctl`.
Which permissions does RemCTL need?
Three, all for the RemCTL Capability Host app: Reminders, Automation for Reminders and Full Disk Access. `remctl doctor` checks them.
How do I connect RemCTL to Claude Desktop?
Run `remctl mcp install --client claude-desktop` and restart Claude. Another path: `remctl mcp bundle --open` installs it as a one-click extension.
What does the Today band show in Claude Code?
How many tasks remain today and how many are overdue, counts per list and the next tasks with their times. The `display` setting changes the view: `band`, `compact`, `status` or `pane only`.
Does RemCTL work on an Intel Mac?
Yes, but only through a source build: the prebuilt DMG is for Apple silicon. You need the Command Line Tools and `./install.sh --from-source --bootstrap`.
Discussion
No questions or reviews yet.
Related
CLI toolsA local MCP server for Mac: Claude, Codex and ChatGPT work in apps, files, terminal and browser under your permissions
Code-Notify sends a desktop notification when Claude Code, Codex or Gemini CLI finishes a task or waits for your input
A macOS menu bar app writes the text of your focused windows into markdown, and its MCP server serves that record to agents
Meeting notes on Mac and an MCP for agents: Markdown transcripts, search, recaps and action items, with no bot joining the call
A remote for Codex and Claude Code from iPhone and iPad: follow progress, reply and approve what the agent does on your computer.
Claude Code hooks for macOS: a notification returns you to the original terminal window, and a push reaches your phone when idle.
README in short
The README describes RemCTL as full control of Apple Reminders from the terminal, AI apps, a Reminders workspace in Codex and a Today band in Claude Code. It covers installation (DMG or source build), permissions, a version upgrade table and CLI command examples. The sections on AI apps, Claude Code and Codex explain the MCP server, the plugins and the Today band settings.