calendar-microsoft

name	calendar-microsoft
description	View and search calendar events from Mac Calendar.app — realtime, zero network calls
allowed-tools	Bash, Read, Write, Glob, Grep

Calendar — Mac Calendar.app

Read calendar events from locally synced accounts. All queries via JXA — zero network calls.

Setup

cd /Users/chensijie/Projects/claude-secretary && source venv/bin/activate

Commands

List Calendars

python scripts/mac_calendar.py calendars

Today's Events

python scripts/mac_calendar.py today

This Week (next 7 days)

python scripts/mac_calendar.py week

Specific Date

python scripts/mac_calendar.py date 2026-03-30

Date Range

python scripts/mac_calendar.py range 2026-03-27 2026-04-10

Search Events

python scripts/mac_calendar.py search "seminar" --days 30

Output Format

Commands return {"events": [...], "conflicts": [...]}. Each event includes: summary, start, end, location, calendar, allDay, attendees, description. Conflicts are automatically detected for overlapping timed events.

Behavior

1. Check schedule: Default to today. If user asks "this week", use week.
2. Present events as a clean timeline: time, title, location/link.
3. Highlight conflicts if any overlapping events detected.
4. Meeting prep: Show attendees, description, and join URL from location field.
5. Times are UTC in raw output — convert to Pacific Time (UTC-7) when presenting.