# Google Calendar

> Manage Google Calendar events via the Google Calendar API using curl + OAuth tokens.

- Skill: `thinkfleetai/google-calendar` (Agent Skill)
- Install (CLI): `npx skillmds@latest add thinkfleetai/google-calendar`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thinkfleetai/google-calendar/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: thinkfleetai (https://skillmd.com/u/thinkfleetai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/thinkfleetai/google-calendar

---


# Google Calendar

Interact with Google Calendar API.

## Environment Variables

- `GOOGLE_ACCESS_TOKEN` - OAuth2 access token with `calendar` scope

## List upcoming events

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

## Create an event

```bash
curl -s -X POST \
  -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events" \
  -d '{
    "summary": "Meeting with team",
    "start": {"dateTime": "2025-01-15T10:00:00-05:00"},
    "end": {"dateTime": "2025-01-15T11:00:00-05:00"}
  }' | jq '{id, summary, htmlLink}'
```

## Delete an event

```bash
curl -s -X DELETE \
  -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN" \
  "https://www.googleapis.com/calendar/v3/calendars/primary/events/EVENT_ID"
```

## Notes

- Token refresh is handled externally (via SaaS credential store).
- Always confirm before creating/deleting events.