← Back to Skills Marketplace
Apple Calendar Manager
by
CryptoL0rd
· GitHub ↗
· v1.0.0
559
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install apple-calendar-manager
Description
Manage Apple Calendar events via AppleScript. Create, edit, delete, and search calendar events.
README (SKILL.md)
Apple Calendar Manager
This skill allows OpenClaw to manage events in Apple Calendar using AppleScript.
Capabilities
- Add new events to a specified calendar with smart date parsing (e.g., "today", "tomorrow", "next Monday").
- (Future) Edit existing events.
- (Future) Delete events.
- (Future) Search for events.
Requirements
- macOS
- Apple Calendar application must be accessible and authorized for automation.
- The calendar name must exist in the user's Calendar app.
Usage
Add an Event (Smart Date Parsing)
Use the add_event_smart.sh script to add events with relative dates or explicit dates.
Arguments:
calendar_name: The name of the calendar (e.g., "Рабочий", "Домашний").event_summary: The title of the event.event_description: (Optional) Description for the event.relative_start_date: Relative date for start (e.g., "today", "tomorrow", "day after tomorrow", "понедельник", "next monday") or absolute date (e.g., "2026-02-23").start_time: Start time (format HH:MM, e.g., "12:00").relative_end_date: Relative date for end (same asrelative_start_date).end_time: End time (format HH:MM, e.g., "15:00").
Example:
skills/apple-calendar-manager/add_event_smart.sh "Рабочий" "Чай с Настей" "Чай с Настей с 12 до 15" "tomorrow" "12:00" "tomorrow" "15:00"
Add an Event (Absolute Date Parsing)
Use the add_event.scpt script directly if you prefer to provide absolute dates in YYYYMMDDHHMMSS format.
Arguments:
calendar_name: The name of the calendar.event_summary: The title of the event.event_description: Description for the event.start_datetime_formatted: Start date and time inYYYYMMDDHHMMSSformat.end_datetime_formatted: End date and time inYYYYMMDDHHMMSSformat.
Example:
osascript skills/apple-calendar-manager/add_event.scpt "Рабочий" "Тест скилла Календарь" "Тестовое событие" "20260225140000" "20260225150000"
Implementation Details
- Uses
osascriptfor direct Apple Calendar application control. parse_relative_date.shscript handles conversion of relative date strings to absolute date/time formats required by AppleScript.- Requires Apple Calendar.app to be running and accessible.
- macOS-only.
Usage Guidance
This package mostly looks like a local Apple Calendar helper, but do not install or run it yet. Key issues to check before proceeding:
- The SKILL.md and add_event_smart.sh call add_event.scpt, but add_event.scpt is not included — request the missing AppleScript file and inspect it for any unexpected behavior (network calls, file writes, credentials exfiltration) before running.
- The scripts invoke 'osascript' (AppleScript runner) but the skill doesn't declare that dependency; ensure your environment is macOS and you understand that osascript will control Calendar.app and will require you to grant automation permissions.
- parse_relative_date.sh has logic bugs around weekday handling and Russian weekday support; test thoroughly to avoid creating events at the wrong time.
- Because the skill controls a local app, it can create/modify calendar events — only grant automation permission if you trust the inspected AppleScript implementation.
- If you obtain the missing add_event.scpt, review its source for any network access or file-system operations. Prefer running in a controlled account/profile and back up important calendar data before use.
If the author provides the missing AppleScript and fixes the parsing logic and dependency declarations, the skill appears coherent and low-risk; as-is, missing components and inconsistencies make it suspicious.
Capability Analysis
Type: OpenClaw Skill
Name: apple-calendar-manager
Version: 1.0.0
The `parse_relative_date.sh` script contains a critical shell injection vulnerability. The `RELATIVE_DATE` argument is directly interpolated into the `date -v"next $RELATIVE_DATE_EN"` command without proper sanitization or quoting, allowing an attacker to inject arbitrary shell commands via command substitution or command separation. This flaw could lead to arbitrary code execution on the host system when the `add_event_smart.sh` skill is invoked with a specially crafted `RELATIVE_DATE` argument.
Capability Assessment
Purpose & Capability
The skill claims to manage Apple Calendar via AppleScript and includes helper shell scripts, which is coherent. However SKILL.md and add_event_smart.sh call an add_event.scpt AppleScript that is not included in the package — a critical missing piece. The skill also fails to declare that it needs the 'osascript' binary (used to run AppleScript). These omissions make the packaged contents insufficient for the stated purpose.
Instruction Scope
Instructions limit runtime actions to local AppleScript control of Calendar (osascript) and local date parsing; there are no network calls or attempts to read unrelated system files. However, the scripts assume Calendar GUI automation permission and a specific path (skills/apple-calendar-manager/add_event.scpt). The included parse_relative_date.sh contains logic bugs (weekday matching/translations are inconsistent) that could cause parsing failures or errors when given Russian weekday names.
Install Mechanism
This is instruction-only with two small included shell scripts and no install/download step. No remote URLs or archive extraction are used — low install risk.
Credentials
No environment variables or external credentials are requested, which is proportionate. The skill will require user-level Calendar automation permission on macOS; that privilege is appropriate for the stated functionality but should be granted intentionally. The SKILL.md does not declare the required 'osascript' dependency.
Persistence & Privilege
always is false and there is no install script that attempts to persistently modify agent or system configuration. The skill does not request elevated or persistent privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install apple-calendar-manager - After installation, invoke the skill by name or use
/apple-calendar-manager - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Allows adding events to Apple Calendar using relative dates (today, tomorrow, day after tomorrow, next Monday) and explicit dates via AppleScript.
Metadata
Frequently Asked Questions
What is Apple Calendar Manager?
Manage Apple Calendar events via AppleScript. Create, edit, delete, and search calendar events. It is an AI Agent Skill for Claude Code / OpenClaw, with 559 downloads so far.
How do I install Apple Calendar Manager?
Run "/install apple-calendar-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Apple Calendar Manager free?
Yes, Apple Calendar Manager is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Apple Calendar Manager support?
Apple Calendar Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Apple Calendar Manager?
It is built and maintained by CryptoL0rd (@cryptol0rd); the current version is v1.0.0.
More Skills