← Back to Skills Marketplace
558
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install apple-calendar-ops
Description
Read, create, update, and delete Apple Calendar events via CalDAV. Use when the user wants to inspect calendars or events, add a calendar event, change an ex...
README (SKILL.md)
Apple Calendar Ops
This skill is the Apple Calendar operation layer.
It handles stable calendar reads and writes. It does not do high-level scheduling, cross-system planning, or task prioritization.
Core boundary
Use this skill for concrete Apple Calendar operations:
- list calendars
- fetch events in a time range
- create an event
- update an event
- delete an event
Do not use this skill to decide how the day should be planned. That belongs to a higher-level task/orchestrator.
Operating rules
Default stance:
- reads are safe
- writes should be dry-run-friendly
- updates/deletes should prefer explicit event ids
- fuzzy title matching may help locate events, but should not be the only basis for risky writes
Credentials should come from /home/agent/.openclaw/workspace/secrets.json.
Read references/boundary.md before changing the skill's scope.
Read references/event-contract.md before writing or consuming event JSON.
Quick start
Read calendars
python3 /home/agent/.openclaw/workspace/skills/apple-calendar-ops/scripts/calendar_fetch.py --list-calendars
Read events
python3 /home/agent/.openclaw/workspace/skills/apple-calendar-ops/scripts/calendar_fetch.py \
--start 2026-03-12T00:00:00+08:00 \
--end 2026-03-13T00:00:00+08:00
Create event
python3 /home/agent/.openclaw/workspace/skills/apple-calendar-ops/scripts/calendar_create.py \
--calendar "Calendar" \
--title "Example event" \
--start 2026-03-12T14:00:00+08:00 \
--end 2026-03-12T15:00:00+08:00 \
--dry-run
Scripts
scripts/calendar_common.py— shared config, secret loading, and JSON helpersscripts/calendar_fetch.py— list calendars and fetch eventsscripts/calendar_create.py— create an eventscripts/calendar_update.py— update an eventscripts/calendar_delete.py— delete an event
References
references/boundary.md— scope and non-goalsreferences/event-contract.md— normalized event shape for all scripts
First-version goal
Version 1 should make Apple Calendar readable and safely writable.
That means:
- reliable read access for scheduler inputs
- explicit create/update/delete flows
- machine-readable output
- conservative handling of risky writes
Usage Guidance
This skill largely does what it claims (CalDAV read/write to Apple Calendar), but before installing you should: 1) Inspect /home/agent/.openclaw/workspace/secrets.json and ensure it only contains the appleCalendar keys (appleId and appSpecificPassword) — the skill reads the entire file. 2) Prefer using an Apple app‑specific password (not your main Apple password). 3) Confirm the caldav baseUrl (defaults to caldav.icloud.com) and any configured calendarUrls to restrict which calendars the skill can access. 4) Because the registry metadata does not declare the secrets/config path, treat that as a packaging omission — either update the registry entry or avoid running the skill until you can control where credentials come from. 5) Run first with --dry-run or --list-calendars to verify behavior. If you are not comfortable with a local secrets.json being read, do not install/run the skill until the credential handling is clarified.
Capability Analysis
Type: OpenClaw Skill
Name: apple-calendar-ops
Version: 0.1.0
The skill bundle provides a standard implementation for managing Apple Calendar events via the CalDAV protocol. It includes scripts for fetching, creating, updating, and deleting events (calendar_fetch.py, calendar_create.py, etc.) and correctly handles credentials from the designated workspace secrets file. No evidence of data exfiltration to unauthorized endpoints, malicious execution, or prompt injection was found; the code uses standard libraries like urllib and icalendar for its stated purpose.
Capability Assessment
Purpose & Capability
The code implements CalDAV operations (discover, list, fetch, create, update, delete) which matches the description. However the SKILL metadata declares no required config paths or credentials while the SKILL.md and the code hard‑code a secrets file path (/home/agent/.openclaw/workspace/secrets.json). The skill legitimately needs Apple ID + app‑specific password, but the registry metadata omission is an incoherence.
Instruction Scope
Runtime instructions and scripts are narrowly scoped to CalDAV operations and call only the CalDAV endpoint (default https://caldav.icloud.com). The SKILL.md explicitly instructs the agent to read a local secrets.json for credentials; the code's load_all_secrets() reads the whole JSON file. This is within expected scope for an Apple Calendar CalDAV tool, but the explicit dependency on a workspace secrets file should be noted and checked.
Install Mechanism
There is no install spec or external download. The skill is instruction-plus-scripts included in the bundle. No network install or archive extraction is performed at install time, which lowers install-time risk.
Credentials
The skill requires Apple credentials (appleId and appSpecificPassword) which are proportionate to CalDAV access. However the declared registry requirements list no env vars or config paths while the code expects and reads a workspace secrets.json containing these credentials. The code reads the full secrets.json (load_all_secrets()), not only the appleCalendar keys, so if that file contains unrelated sensitive values they would be accessible to this skill.
Persistence & Privilege
The skill does not request always:true and does not attempt to modify other skills or global agent settings. It runs as contained scripts and only acts when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install apple-calendar-ops - After installation, invoke the skill by name or use
/apple-calendar-ops - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release: Apple Calendar read/create/update/delete via CalDAV with structured JSON output.
Metadata
Frequently Asked Questions
What is Apple Calendar Ops?
Read, create, update, and delete Apple Calendar events via CalDAV. Use when the user wants to inspect calendars or events, add a calendar event, change an ex... It is an AI Agent Skill for Claude Code / OpenClaw, with 558 downloads so far.
How do I install Apple Calendar Ops?
Run "/install apple-calendar-ops" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Apple Calendar Ops free?
Yes, Apple Calendar Ops is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Apple Calendar Ops support?
Apple Calendar Ops is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Apple Calendar Ops?
It is built and maintained by ClawEnd (@ivy-end); the current version is v0.1.0.
More Skills