How do I install the Google Calendar skill?

Run npx skillmds@latest add qhkm/google-calendar 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.

What does the Google Calendar skill do?

List, create, update, and delete Google Calendar events via the Calendar API v3. It is listed under Integrations & APIs on SkillMD.

Is Google Calendar safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Google Calendar?

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 Google Calendar free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Google Calendar?

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

Google Calendar by qhkm — Agent Skill

Name: Google Calendar
Author: qhkm

File contents

Google Calendar Skill

Manage Google Calendar events — list upcoming, create, update, and delete events using the Calendar API v3.

Setup

Create a project at console.cloud.google.com
Enable the Google Calendar API
Create OAuth 2.0 credentials or use a service account
Get an access token:

# If you have gcloud CLI installed:
export GOOGLE_ACCESS_TOKEN=$(gcloud auth print-access-token)

# Or set manually from OAuth flow:
export GOOGLE_ACCESS_TOKEN="ya29.xxx..."
export CALENDAR_ID="primary"

List Upcoming Events

curl -s "https://www.googleapis.com/calendar/v3/calendars/${CALENDAR_ID:-primary}/events?maxResults=10&orderBy=startTime&singleEvents=true&timeMin=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  | jq '.items[] | {summary, start: .start.dateTime, end: .end.dateTime, id}'

Create an Event

curl -s -X POST "https://www.googleapis.com/calendar/v3/calendars/${CALENDAR_ID:-primary}/events" \
  -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "Team Standup",
    "start": {"dateTime": "2026-03-01T09:00:00+08:00"},
    "end": {"dateTime": "2026-03-01T09:30:00+08:00"},
    "description": "Daily standup meeting",
    "location": "Google Meet"
  }' | jq '{id, summary, htmlLink}'

Update an Event

EVENT_ID="event-id-from-list"
curl -s -X PATCH "https://www.googleapis.com/calendar/v3/calendars/${CALENDAR_ID:-primary}/events/$EVENT_ID" \
  -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"summary": "Updated Meeting Title"}' | jq '{id, summary, updated}'

Delete an Event

EVENT_ID="event-id-from-list"
curl -s -X DELETE "https://www.googleapis.com/calendar/v3/calendars/${CALENDAR_ID:-primary}/events/$EVENT_ID" \
  -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  -w "\nHTTP Status: %{http_code}\n"

Tips

CALENDAR_ID defaults to primary if not set
Use singleEvents=true to expand recurring events into individual instances
Token expires every ~60 minutes — refresh with gcloud auth print-access-token
Rate limit: 1,000,000 queries/day (generous)
Time format must be RFC 3339 with timezone offset
All-day events use date field instead of dateTime

---name: google-calendardescription: List, create, update, and delete Google Calendar events via the Calendar API v3.license: MIT---# Google Calendar SkillManage Google Calendar events — list upcoming, create, update, and delete events using the Calendar API v3.## Setup1. Create a project at [console.cloud.google.com](https://console.cloud.google.com)2. Enable the **Google Calendar API**3. Create OAuth 2.0 credentials or use a service account4. Get an access token:```bash# If you have gcloud CLI installed:export GOOGLE_ACCESS_TOKEN=$(gcloud auth print-access-token)# Or set manually from OAuth flow:export GOOGLE_ACCESS_TOKEN="ya29.xxx..."export CALENDAR_ID="primary"```## List Upcoming Events```bashcurl -s "https://www.googleapis.com/calendar/v3/calendars/${CALENDAR_ID:-primary}/events?maxResults=10&orderBy=startTime&singleEvents=true&timeMin=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \ -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \ | jq '.items[] | {summary, start: .start.dateTime, end: .end.dateTime, id}'```## Create an Event```bashcurl -s -X POST "https://www.googleapis.com/calendar/v3/calendars/${CALENDAR_ID:-primary}/events" \ -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "summary": "Team Standup", "start": {"dateTime": "2026-03-01T09:00:00+08:00"}, "end": {"dateTime": "2026-03-01T09:30:00+08:00"}, "description": "Daily standup meeting", "location": "Google Meet" }' | jq '{id, summary, htmlLink}'```## Update an Event```bashEVENT_ID="event-id-from-list"curl -s -X PATCH "https://www.googleapis.com/calendar/v3/calendars/${CALENDAR_ID:-primary}/events/$EVENT_ID" \ -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"summary": "Updated Meeting Title"}' | jq '{id, summary, updated}'```## Delete an Event```bashEVENT_ID="event-id-from-list"curl -s -X DELETE "https://www.googleapis.com/calendar/v3/calendars/${CALENDAR_ID:-primary}/events/$EVENT_ID" \ -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \ -w "\nHTTP Status: %{http_code}\n"```## Tips- `CALENDAR_ID` defaults to `primary` if not set- Use `singleEvents=true` to expand recurring events into individual instances- Token expires every ~60 minutes — refresh with `gcloud auth print-access-token`- Rate limit: 1,000,000 queries/day (generous)- Time format must be RFC 3339 with timezone offset- All-day events use `date` field instead of `dateTime`

Frequently asked questions

Google Calendar