szoloth/calendar-manager

Calendar Manager

Manage calendars using Apple Calendar via osascript. This is the source of truth - it aggregates both DreamWorks (work) and personal ([email protected]) calendars.

Why Apple Calendar?

• Single source of truth for all calendars (work + personal)
• No OAuth concerns for work calendar access
• Token efficient - osascript is fast and returns plain text

Available Calendars

Run this to see all calendars:

osascript -e 'tell application "Calendar" to get name of every calendar'

Common calendars:

• Gcal - Primary - Personal ([email protected])
• [email protected] - Work (DreamWorks)
• Home, Work - Local calendars
• Funemployment - Job search related

Available Operations

Get today's events (all calendars)

osascript -e '
set todayStart to current date
set time of todayStart to 0
set todayEnd to todayStart + (24 * 60 * 60)
tell application "Calendar"
    set output to ""
    repeat with cal in calendars
        set calEvents to (every event of cal whose start date ≥ todayStart and start date < todayEnd)
        repeat with e in calEvents
            set output to output & (time string of (start date of e)) & " - " & (summary of e) & " [" & (name of cal) & "]" & linefeed
        end repeat
    end repeat
    return output
end tell
'

Get this week's events

osascript -e '
set todayStart to current date
set time of todayStart to 0
set weekEnd to todayStart + (7 * 24 * 60 * 60)
tell application "Calendar"
    set output to ""
    repeat with cal in calendars
        set calEvents to (every event of cal whose start date ≥ todayStart and start date < weekEnd)
        repeat with e in calEvents
            set eventDate to date string of (start date of e)
            set eventTime to time string of (start date of e)
            set output to output & eventDate & " " & eventTime & " - " & (summary of e) & linefeed
        end repeat
    end repeat
    return output
end tell
'

Get first meeting of the day

osascript -e '
set todayStart to current date
set time of todayStart to 0
set todayEnd to todayStart + (24 * 60 * 60)
tell application "Calendar"
    set firstEvent to missing value
    set firstTime to todayEnd
    repeat with cal in calendars
        set calEvents to (every event of cal whose start date ≥ todayStart and start date < todayEnd)
        repeat with e in calEvents
            if start date of e < firstTime then
                set firstTime to start date of e
                set firstEvent to e
            end if
        end repeat
    end repeat
    if firstEvent is not missing value then
        return (time string of (start date of firstEvent)) & " - " & (summary of firstEvent)
    else
        return "No meetings today"
    end if
end tell
'

Get events from specific calendar

osascript -e '
set todayStart to current date
set time of todayStart to 0
set todayEnd to todayStart + (24 * 60 * 60)
tell application "Calendar"
    set cal to calendar "Gcal - Primary"
    set calEvents to (every event of cal whose start date ≥ todayStart and start date < todayEnd)
    set output to ""
    repeat with e in calEvents
        set output to output & (time string of (start date of e)) & " - " & (summary of e) & linefeed
    end repeat
    return output
end tell
'

Create event on personal calendar

osascript -e '
tell application "Calendar"
    set targetCal to calendar "Gcal - Primary"
    set newEvent to make new event at end of events of targetCal with properties {summary:"Interview with Gusto", start date:date "January 20, 2025 2:00 PM", end date:date "January 20, 2025 3:00 PM", location:"Zoom"}
    return "Created: " & summary of newEvent
end tell
'

Create all-day event

osascript -e '
tell application "Calendar"
    set targetCal to calendar "Gcal - Primary"
    set eventStart to date "January 20, 2025"
    set eventEnd to date "January 21, 2025"
    set newEvent to make new event at end of events of targetCal with properties {summary:"Vacation Day", start date:eventStart, end date:eventEnd, allday event:true}
    return "Created all-day event: " & summary of newEvent
end tell
'

Search events by keyword

osascript -e '
set searchTerm to "interview"
set todayStart to current date
set time of todayStart to 0
set futureEnd to todayStart + (30 * 24 * 60 * 60)
tell application "Calendar"
    set output to ""
    repeat with cal in calendars
        set calEvents to (every event of cal whose start date ≥ todayStart and start date < futureEnd)
        repeat with e in calEvents
            if (summary of e) contains searchTerm then
                set eventDate to date string of (start date of e)
                set eventTime to time string of (start date of e)
                set output to output & eventDate & " " & eventTime & " - " & (summary of e) & linefeed
            end if
        end repeat
    end repeat
    return output
end tell
'

Delete event

osascript -e '
tell application "Calendar"
    set targetCal to calendar "Gcal - Primary"
    set eventsToDelete to (every event of targetCal whose summary is "Event Title to Delete")
    repeat with e in eventsToDelete
        delete e
    end repeat
    return "Deleted " & (count of eventsToDelete) & " event(s)"
end tell
'

Job Search Use Cases

Check upcoming interviews

osascript -e '
set todayStart to current date
set time of todayStart to 0
set futureEnd to todayStart + (14 * 24 * 60 * 60)
tell application "Calendar"
    set output to ""
    repeat with cal in calendars
        set calEvents to (every event of cal whose start date ≥ todayStart and start date < futureEnd)
        repeat with e in calEvents
            set eventSummary to summary of e
            if eventSummary contains "interview" or eventSummary contains "Interview" then
                set eventDate to date string of (start date of e)
                set eventTime to time string of (start date of e)
                set output to output & eventDate & " " & eventTime & " - " & eventSummary & linefeed
            end if
        end repeat
    end repeat
    if output is "" then
        return "No upcoming interviews in next 14 days"
    else
        return output
    end if
end tell
'

Schedule interview on personal calendar

osascript -e '
tell application "Calendar"
    set targetCal to calendar "Gcal - Primary"
    set newEvent to make new event at end of events of targetCal with properties {summary:"Gusto PM Interview", start date:date "January 20, 2025 2:00 PM", end date:date "January 20, 2025 3:00 PM", location:"Zoom link here", description:"Role: PM, Interviewer: [Name]"}
    return "Created interview: " & summary of newEvent & " at " & (time string of start date of newEvent)
end tell
'

Best Practices

When creating events

1. Use descriptive titles including company name
2. Always add location (Zoom link, address, phone)
3. For interviews, create on personal calendar (Gcal - Primary)
4. Include prep notes in description

Date/Time format in osascript

• date "January 20, 2025 2:00 PM" - explicit format
• current date - now
• current date + (24 * 60 * 60) - tomorrow

Token Efficiency

Uses osascript directly via Bash:

• No MCP tool definitions loaded
• Plain text output
• Single Bash tool call

Integration

Works well with:

• gmail-manager: Check interview invites from email, then add to calendar
• morning-kickstart: Calendar feeds into daily planning
• Things MCP: Cross-reference calendar with task deadlines

Note on Personal vs Work

• Read: Can read from ALL calendars (work + personal)
• Write: Only create events on personal calendar (Gcal - Primary)
• For work calendar events, use the DreamWorks calendar web interface