Skip to content
Back to search

orca-apple-reminders

Apple Reminders in Orca: sidebar lists, notes, due dates, and Claude Code/Codex commands via the Orca CLI. No separate MCP server. Agent commands require a development copy.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ishubhoshaha--orca-apple-reminders/badge.svg)](/listings/ishubhoshaha--orca-apple-reminders)

HTML

<a href="/listings/ishubhoshaha--orca-apple-reminders"><img src="/api/listings/ishubhoshaha--orca-apple-reminders/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires the Orca desktop app **1.4.246 or later**, running locally on **macOS**. Windows, Linux and remote Orca hosts cannot access your Mac’s Reminders.

In a terminal:

orca plugin install ishubhoshaha/orca-apple-reminders@v0.2.2 --json

Orca shows the plugin’s access and returns an approval command. Review that access and run the exact command Orca supplies to enable the plugin. This is a community plugin with a local Node worker: it runs with your Mac account’s filesystem and process access so it can use the Reminders scripting interface. It requests no additional Orca workspace, agent, terminal, secret or storage APIs.

Then open the panel:

orca plugin open ishubhoshaha.apple-reminders --panel apple-reminders --json

You can also install from the repository URL in Orca’s plugin settings. After the plugin directory lists this release, search for **Apple Reminders** by **ishubhoshaha**.

macOS permission

Allow the macOS permission prompt for access to Reminders. If access was refused, open **System Settings → Privacy & Security → Automation**, enable Reminders under Orca (or the host macOS names in its prompt), and refresh. Launch the Reminders app once if it has never been opened.

Updates and removal

orca plugin update ishubhoshaha.apple-reminders --json
orca plugin uninstall ishubhoshaha.apple-reminders --json

Uninstalling the plugin leaves your reminders in Apple Reminders.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 173 lines
  1. <img src="assets/icon.png" alt="Apple Reminders for Orca" width="80" height="80" />
  2. # Apple Reminders for Orca
  3. Use Apple Reminders from **Orca’s sidebar**, or ask **Claude Code and Codex** to create reminders through the Orca CLI. **No separate MCP server is needed.** macOS manages iCloud sync; the plugin needs no Apple password, Google account, API key or npm dependency.
  4. Agent commands currently require an approved **development copy** of the plugin. The sidebar also works with a normal marketplace or Git installation.
  5. - Browse your reminder lists and search pending or completed items.
  6. - Add reminders with notes, date-only deadlines, or timed alerts.
  7. - Complete reminders and restore completed items.
  8. - Ask Claude Code or Codex to create reminders in your default list or a specific list.
  9. - Refresh manually anytime, or automatically every 30 minutes while Orca is active and the panel is visible.
  10. ## Quick examples
  11. After completing the [agent setup](#one-time-setup-for-agent-commands), paste this into Claude Code or Codex:
  12. > Use my Orca Apple Reminders plugin. First run `orca plugin dev request local.apple-reminders reminders.help --json`. Then remind me to review the PR tomorrow at 10 AM in my default list.
  13. More requests you can make after the agent has read the guide:
  14. - “Add ‘Read the API design notes’ to my default list, without a due date.”
  15. - “In my Work list, remind me to check the staging deployment on December 1, 2026 at 9:30 AM. Add a note: ‘Check health checks and error logs.’”
  16. - “Add ‘Renew passport’ to my Personal list, due December 5, 2026, with no specific time.”
  17. - “Show my reminder lists and tell me which is the default.”
  18. - “Create three undated reminders in my default list: review the PR, update the runbook, and check the rollout dashboard.”
  19. These are prompts for your agent. The agent resolves natural-language dates and calls the plugin with explicit dates. List names such as Work and Personal are examples; use names returned by `reminders.lists` on your Mac. A multi-reminder request requires one `reminders.add` call per item.
  20. For copyable CLI examples, list-ID selection, reusable agent instructions, and troubleshooting, see **[Usage examples](docs/EXAMPLES.md)**.
  21. ## Use
  22. Open the **Apple Reminders** tab (bell icon) in Orca’s right sidebar. Choose a list, search its reminders, or switch between Pending and Completed. Check an item to complete it; uncheck it in Completed to restore it.
  23. Press **+** to add a reminder. Choose its list, title, optional notes, and optional due date:
  24. - `2026-12-01`: date only.
  25. - `2026-12-01 09:00`: date and time, with a reminder alert.
  26. - Leave it blank for no date.
  27. Dates use your Mac’s current time zone. Automatic refresh runs every 30 minutes, only when Orca is the foreground app and this panel is visible. Inactive or hidden checks are skipped. Opening or reloading the panel loads reminders immediately, even if Orca is in the background; the active-app check applies only to later scheduled refreshes. Press refresh anytime in between, including after another app or agent makes a change. Creating or completing a reminder updates the panel immediately. Apple’s sync can take time; a local save does not confirm that iCloud has already synced it.
  28. ## Install
  29. Requires the Orca desktop app **1.4.246 or later**, running locally on **macOS**. Windows, Linux and remote Orca hosts cannot access your Mac’s Reminders.
  30. In a terminal:
  31. ```sh
  32. orca plugin install ishubhoshaha/orca-apple-reminders@v0.2.2 --json
  33. ```
  34. Orca shows the plugin’s access and returns an approval command. Review that access and run the exact command Orca supplies to enable the plugin. This is a community plugin with a local Node worker: it runs with your Mac account’s filesystem and process access so it can use the Reminders scripting interface. It requests no additional Orca workspace, agent, terminal, secret or storage APIs.
  35. Then open the panel:
  36. ```sh
  37. orca plugin open ishubhoshaha.apple-reminders --panel apple-reminders --json
  38. ```
  39. You can also install from the repository URL in Orca’s plugin settings. After the plugin directory lists this release, search for **Apple Reminders** by **ishubhoshaha**.
  40. ### macOS permission
  41. Allow the macOS permission prompt for access to Reminders. If access was refused, open **System Settings → Privacy & Security → Automation**, enable Reminders under Orca (or the host macOS names in its prompt), and refresh. Launch the Reminders app once if it has never been opened.
  42. ### Updates and removal
  43. ```sh
  44. orca plugin update ishubhoshaha.apple-reminders --json
  45. orca plugin uninstall ishubhoshaha.apple-reminders --json
  46. ```
  47. Uninstalling the plugin leaves your reminders in Apple Reminders.
  48. ## Claude Code and Codex commands — no MCP server
  49. Claude Code and Codex can use their shell tools to call the plugin worker directly through Orca’s CLI. Orca must be running on the same Mac; it can be in the background. No separate MCP server, Node service or Apple account credentials are needed.
  50. **Current Orca limitation:** `orca plugin dev request` accepts approved **development plugins only**. A marketplace or Git-installed copy supports the sidebar, but agent calls require the development setup below. Your agent needs permission to run the `orca` CLI.
  51. ### One-time setup for agent commands
  52. If you already use a development copy named `local.apple-reminders`, update it to this release and reload it. Otherwise:
  53. ```sh
  54. git clone https://github.com/ishubhoshaha/orca-apple-reminders.git
  55. cd orca-apple-reminders
  56. git checkout v0.2.2
  57. orca plugin dev load . --json
  58. ```
  59. Review and run Orca’s exact approval command. Keep this folder where it is while using it. Disable an installed copy if you want to avoid duplicate sidebar panels.
  60. The following calls work from any project on that Mac:
  61. ```sh
  62. # Discover commands and the Mac’s current time zone.
  63. orca plugin dev request local.apple-reminders reminders.help --json
  64. # Discover real list names and IDs, and the Mac’s default list.
  65. orca plugin dev request local.apple-reminders reminders.lists --timeout-ms 65000 --json
  66. # Create in the Mac’s default list.
  67. orca plugin dev request local.apple-reminders reminders.add \
  68. --data '{"title":"Review the PR","due":"2026-12-01 10:00"}' \
  69. --timeout-ms 65000 --json
  70. # Create in a specific list. Names must match an existing list exactly, ignoring case.
  71. orca plugin dev request local.apple-reminders reminders.add \
  72. --data '{"title":"Book a dentist appointment","list":"Personal","notes":"Ask about morning availability"}' \
  73. --timeout-ms 65000 --json
  74. ```
  75. `reminders.add` accepts a required `title`, optional `list` or `listId`, optional `notes`, and optional `due`. Omitting the selector uses the Mac’s default list. Duplicate names fail rather than guessing: get the list IDs with `reminders.lists` and pass `listId` instead. Due dates use local `YYYY-MM-DD` or `YYYY-MM-DD HH:mm`; a time also sets an alert. The successful result includes the created reminder ID, title, selected list and due date. An open sidebar updates after creation.
  76. ### Teach an agent once, then use natural language
  77. Start a chat with the discovery command shown in [Quick examples](#quick-examples), then ask for reminders in your own words. From any project on the same Mac, both agents use the same `local.apple-reminders` plugin.
  78. To reuse this in future chats, add the short snippet in [Usage examples](docs/EXAMPLES.md#reuse-in-future-agent-chats) to a project’s `CLAUDE.md` for Claude Code or `AGENTS.md` for Codex. [docs/AGENT_USAGE.md](docs/AGENT_USAGE.md) contains the fuller agent reference. Installing the plugin does not automatically edit those files or register an MCP tool.
  79. The command palette also includes **Apple Reminders: Agent command guide** and **Apple Reminders: List reminder lists**.
  80. ### Do I still need the old MCP server?
  81. For creating reminders through this plugin, no. The existing `apple-productivity-local` connection can coexist, or you can remove it from Claude Code:
  82. ```sh
  83. claude mcp remove apple-productivity-local --scope user
  84. ```
  85. Restart Claude Code after removing it. Your reminders remain in Apple Reminders. That MCP server may also provide **Calendar** access; this plugin handles **Reminders only**, so keep the server if you still need its calendar tools.
  86. ## Scope and limits
  87. - Reads reminder lists and items; creates reminders; changes completion state. It has no delete or edit-existing-reminder control.
  88. - Fetches up to 300 items in the selected view and shows 50 per page. A banner identifies truncated results; select a narrower list. Search applies to fetched items.
  89. - Notes are previewed up to 1,000 characters. Existing notes are never rewritten by viewing or completing an item.
  90. - Apple’s scripting interface represents date-only items and items timed at exactly midnight similarly; both appear as date-only in this panel.
  91. - Advanced features such as subtasks, recurrence, tags, attachments, and location alerts remain in Apple Reminders. Completing a repeating reminder can advance its recurrence according to macOS behavior.
  92. - A request timeout can have an uncertain result. Refresh or check Reminders before submitting again, to avoid duplicates.
  93. - This is an independent community plugin, not affiliated with Apple or Orca.
  94. ## Development and validation
  95. Clone the repository and load it as a development plugin:
  96. ```sh
  97. git clone https://github.com/ishubhoshaha/orca-apple-reminders.git
  98. cd orca-apple-reminders
  99. orca plugin dev load . --json
  100. ```
  101. Review and run Orca’s supplied approval command. A development folder uses the id `local.apple-reminders` and reloads when you edit its files. Use `orca plugin dev unload local.apple-reminders --json` to remove that development registration. If an installed copy is also enabled, disable one to avoid duplicate panels.
  102. No build step or runtime dependencies. Orca transpiles TypeScript and TSX. The fixed JXA program in `native/reminders.js` is invoked with `/usr/bin/osascript`; titles, notes and identifiers travel as JSON arguments, never interpolated shell commands. Reminder content is kept in panel memory rather than written to plugin storage. UI filters and an unfinished draft use Orca’s plugin-scoped UI state.
  103. ```sh
  104. orca plugin types . --json
  105. npx --package typescript tsc -p .
  106. orca plugin test . --json
  107. orca plugin check . --json
  108. orca plugin validate . --json
  109. ```
  110. Tests use sample data and do not change real reminders. Check scenarios cover populated lists, no items, and denied permissions. Real integration verification during development used temporary test reminders and removed them afterward.
  111. ## License
  112. [MIT](LICENSE) © 2026 Shubho Shaha.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.