apple-reminders — Claude Code skill: what it does, install
This skill manages Apple Reminders through remindctl, including reminders and lists. Use it when an agent needs to work with tasks synced to Apple devices.
npx skills add openclaw/openclaw --skill apple-reminders -a claude-codeWhat apple-reminders does
apple-reminders gives an agent terminal access to Apple Reminders through the remindctl CLI. It can show reminders for today, tomorrow, the week, or past due dates; manage reminder lists; create tasks with due dates; and complete or delete items.
The skill requires macOS and the remindctl binary. Install it with Homebrew using brew install steipete/tap/remindctl, then grant Reminders access with remindctl authorize. Check permissions with remindctl status. Output can be returned as JSON or TSV for scripting.
Install it when tasks should appear in Apple Reminders and sync to an iPhone or iPad. Use another tool for scheduled agent alerts, calendar events, or project task management.
What it helps with
- create a reminder with a due date
- list overdue Apple Reminders
- manage reminder lists from an agent
- complete reminders by ID
- return tasks as JSON
Example prompts for the agent
- Add “Call mom” to the Personal list for tomorrow.
- Show my overdue reminders as JSON.
- Create a Projects list and add Meeting prep due on `2026-02-15 09:00`.
How to install apple-reminders
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill apple-reminders -a claude-code2Manually: put the files in place
~/.claude/skills/apple-reminders/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/apple-reminders/
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill apple-reminders -a codex2Manually: put the files in place
.agents/skills/apple-reminders/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill apple-reminders -a cursor2Manually: put the files in place
.cursor/skills/apple-reminders/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openclaw/openclaw apple-reminders2Manually: put the files in place
.github/skills/apple-reminders/SKILL.md1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill apple-reminders -a gemini-cli2Platform CLI
gemini skills install https://github.com/openclaw/openclaw --path skills/apple-remindersManually: put the files in place
.devin/skills/apple-reminders/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill apple-reminders -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set45
The whole set →Similar
Questions about apple-reminders
How do I install apple-reminders in Claude Code?
Run npx skills add openclaw/openclaw --skill apple-reminders -a claude-code. The skill file will be placed at ~/.claude/skills/apple-reminders/SKILL.md.
What does apple-reminders do?
It lets an agent manage Apple Reminders through remindctl: view and create reminders, work with lists, and complete or delete tasks.
What does apple-reminders require?
It requires macOS, the remindctl binary, and permission to access Reminders. Request access with remindctl authorize.
Source text
SKILL.md · MIT
---
name: apple-reminders
description: "List, add, edit, complete, or delete Apple Reminders and reminder lists via remindctl."
homepage: https://github.com/steipete/remindctl
metadata:
{
"openclaw":
{
"emoji": "⏰",
"os": ["darwin"],
"requires": { "bins": ["remindctl"] },
"install":
[
{
"id": "brew",
"kind": "brew",
"formula": "steipete/tap/remindctl",
"bins": ["remindctl"],
"label": "Install remindctl via Homebrew",
},
],
},
}
---
# Apple Reminders CLI (remindctl)
Use `remindctl` to manage Apple Reminders directly from the terminal.
## When to Use
Use when:
- User explicitly mentions "reminder" or "Reminders app"
- Creating personal to-dos with due dates that sync to iOS
- Managing Apple Reminders lists
- User wants tasks to appear in their iPhone/iPad Reminders app
## When NOT to Use
Do not use when:
- Scheduling OpenClaw tasks or alerts -> use `cron` tool with systemEvent instead
- Calendar events or appointments -> use Apple Calendar
- Project/work task management -> use Notion, GitHub Issues, or task queue
- One-time notifications -> use `cron` tool for timed alerts
- User says "remind me" but means an OpenClaw alert -> clarify first
## Setup
- Install: `brew install steipete/tap/remindctl`
- macOS-only; grant Reminders permission when prompted
- Check status: `remindctl status`
- Request access: `remindctl authorize`
## Common Commands
### View Reminders
```bash
remindctl # Today's reminders
remindctl today # Today
remindctl tomorrow # Tomorrow
remindctl week # This week
remindctl overdue # Past due
remindctl all # Everything
remindctl 2026-01-04 # Specific date
```
### Manage Lists
```bash
remindctl list # List all lists
remindctl list Work # Show specific list
remindctl list Projects --create # Create list
remindctl list Work --delete # Delete list
```
### Create Reminders
```bash
remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"
```
### Complete/Delete
```bash
remindctl complete 1 2 3 # Complete by ID
remindctl delete 4A83 --force # Delete by ID
```
### Output Formats
```bash
remindctl today --json # JSON for scripting
remindctl today --plain # TSV format
remindctl today --quiet # Counts only
```
## Date Formats
Accepted by `--due` and date filters:
- `today`, `tomorrow`, `yesterday`
- `YYYY-MM-DD`
- `YYYY-MM-DD HH:mm`
- ISO 8601 (`2026-01-04T12:34:56Z`)
## Example: Clarifying User Intent
User: "Remind me to check on the deploy in 2 hours"
**Ask:** "Do you want this in Apple Reminders (syncs to your phone) or as an OpenClaw alert (I'll message you here)?"
- Apple Reminders -> use this skill
- OpenClaw alert -> use `cron` tool with systemEvent
© openclaw · MIT · openclaw/openclaw