How do I install the Calmly skill?

Run npx skillmds@latest add modbender/calmly in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Calmly safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Calmly?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Calmly free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Calmly?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Calmly by modbender — Agent Skill

Name: Calmly
Rating: 4.2 (5 reviews)
Author: modbender

Calmly

Manage macOS Calendar events from the command line using EventKit. Use when creating, listing, or viewing calendar events on macOS without AppleScript dialogs or UI prompts. Supports all-day events, multi-day events, and timed events. Works with iCloud, local, and CalDAV calendars.

modbender Updated Sep 9, 2026 12 repo stars

File contents

calmly

A calm CLI for macOS Calendar. Manage iCloud and local calendars without dialogs, prompts, or UI interruptions.

Why calmly?

AppleScript hangs — Calendar scripting often freezes waiting for permissions
ICS imports pop dialogs — Can't automate without user interaction
icalBuddy is read-only — Can't create events

calmly uses EventKit directly, so it works silently.

Installation

brew tap halbotley/tap
brew install calmly

First run prompts for Calendar access (System Settings → Privacy → Calendars). One-time only.

Commands

List calendars

calmly list

View upcoming events

calmly events Work           # Next 30 days
calmly events Family 14      # Next 14 days

Create all-day event

calmly add Work "Day Off" 2025-03-15

Create multi-day event

calmly add Family "Vacation" 2025-07-01 2025-07-14

Create timed event

calmly addtimed Work "Meeting" 2025-03-15 09:00 10:30
calmly addtimed Kids "Swim Practice" 2025-02-03 07:00 08:30

Batch Event Creation

For recurring events, loop in bash:

# Morning practice every Tuesday/Thursday for 6 weeks
for d in 2025-02-04 2025-02-06 2025-02-11 2025-02-13; do
  calmly addtimed Kids "🏊 AM Practice" "$d" 07:00 08:30
done

Date Verification

Before creating events, verify day/date alignment:

for d in 3 4 5 6 7; do date -j -f "%Y-%m-%d" "2025-02-0$d" "+%A %B %d"; done

Notes

Dates use YYYY-MM-DD format
Times use 24-hour HH:MM format
Calendar names are case-insensitive
Events sync to iCloud automatically
No delete command yet — delete via Calendar app or iCloud web

---name: calmlydescription: Manage macOS Calendar events from the command line using EventKit. Use when creating, listing, or viewing calendar events on macOS without AppleScript dialogs or UI prompts. Supports all-day events, multi-day events, and timed events. Works with iCloud, local, and CalDAV calendars.--- # calmly A calm CLI for macOS Calendar. Manage iCloud and local calendars without dialogs, prompts, or UI interruptions. ## Why calmly? - **AppleScript hangs** — Calendar scripting often freezes waiting for permissions - **ICS imports pop dialogs** — Can't automate without user interaction - **icalBuddy is read-only** — Can't create events calmly uses EventKit directly, so it works silently. ## Installation ```bash brew tap halbotley/tap brew install calmly ``` First run prompts for Calendar access (System Settings → Privacy → Calendars). One-time only. ## Commands ### List calendars ```bash calmly list ``` ### View upcoming events ```bash calmly events Work # Next 30 days calmly events Family 14 # Next 14 days ``` ### Create all-day event ```bash calmly add Work "Day Off" 2025-03-15 ``` ### Create multi-day event ```bash calmly add Family "Vacation" 2025-07-01 2025-07-14 ``` ### Create timed event ```bash calmly addtimed Work "Meeting" 2025-03-15 09:00 10:30 calmly addtimed Kids "Swim Practice" 2025-02-03 07:00 08:30 ``` ## Batch Event Creation For recurring events, loop in bash: ```bash # Morning practice every Tuesday/Thursday for 6 weeks for d in 2025-02-04 2025-02-06 2025-02-11 2025-02-13; do calmly addtimed Kids "🏊 AM Practice" "$d" 07:00 08:30 done ``` ## Date Verification Before creating events, verify day/date alignment: ```bash for d in 3 4 5 6 7; do date -j -f "%Y-%m-%d" "2025-02-0$d" "+%A %B %d"; done ``` ## Notes - Dates use `YYYY-MM-DD` format - Times use 24-hour `HH:MM` format - Calendar names are case-insensitive - Events sync to iCloud automatically - No delete command yet — delete via Calendar app or iCloud web

Frequently asked questions