Google Calendar Skill

Features

• List: See upcoming events to avoid conflicts.
• Create: Schedule new events (meetings, reminders).

Prerequisites

1. Google Cloud Project with Google Calendar API enabled.
2. OAuth 2.0 Credentials (

   credentials.json

   ) in

   ~/.calendar_credentials/

   .

Setup

1. Recommended (gcloud ADC):
   bash

   gcloud auth application-default login --scopes https://www.googleapis.com/auth/calendar.events,https://www.googleapis.com/auth/cloud-platform

   Then verify:
   bash

   uv run skills/google-calendar/scripts/google_calendar.py verify

2. Alternative (credentials.json):
   • Place

     credentials.json

     in

     ~/.calendar_credentials/

     .
   • Run

     uv run skills/google-calendar/scripts/google_calendar.py setup

Usage

1. List Upcoming Events

uv run skills/google-calendar/scripts/google_calendar.py list --limit 5

2. Create Event

# Schedule a Council Meeting
uv run skills/google-calendar/scripts/google_calendar.py create \
  --summary "Jedi Council Meeting" \
  --start "2026-05-04T10:00:00" \
  --end "2026-05-04T11:00:00" \
  --description "Discussing the prophecy."

JSON Output

[
  {
    "summary": "Podrace",
    "start": { "dateTime": "2026-05-04T14:00:00Z" },
    "end": { "dateTime": "2026-05-04T16:00:00Z" }
  }
]