Google Calendar API integration with managed OAuth. Create events, list calendars, check availability, and manage schedules. Use this skill when users want to interact with Google Calendar. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Google Calendar API integration with managed OAuth. Create events, list calendars, check availability, and manage schedules. Use this skill when users want to interact with Google Calendar. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Google Calendar
Access the Google Calendar API with managed OAuth authentication. Create and manage events, list calendars, and check availability.
Replace {native-api-path} with the actual Google Calendar API endpoint path. The gateway proxies requests to www.googleapis.com and automatically injects your OAuth token.
Authentication
All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as MATON_API_KEY:
If omitted, the gateway uses the default (oldest) active connection.
API Reference
List Calendars
GET /google-calendar/calendar/v3/users/me/calendarList
Get Calendar
GET /google-calendar/calendar/v3/calendars/{calendarId}
Use primary for the user's primary calendar.
List Events
GET /google-calendar/calendar/v3/calendars/primary/events?maxResults=10&orderBy=startTime&singleEvents=true
With time bounds:
GET /google-calendar/calendar/v3/calendars/primary/events?timeMin=2024-01-01T00:00:00Z&timeMax=2024-12-31T23:59:59Z&singleEvents=true&orderBy=startTime
Get Event
GET /google-calendar/calendar/v3/calendars/primary/events/{eventId}
Use primary as calendarId for the user's main calendar
Times must be in RFC3339 format (e.g., 2024-01-15T10:00:00Z)
For recurring events, use singleEvents=true to expand instances
orderBy=startTime requires singleEvents=true
IMPORTANT: When using curl commands, use curl -g when URLs contain brackets (fields[], sort[], records[]) to disable glob parsing
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get "Invalid API key" errors when piping.
Error Handling
Status
Meaning
400
Missing Google Calendar connection
401
Invalid or missing Maton API key
429
Rate limited (10 req/sec per account)
4xx/5xx
Passthrough error from Google Calendar API
Troubleshooting: API Key Issues
Check that the MATON_API_KEY environment variable is set:
echo$MATON_API_KEY
Verify the API key is valid by listing connections:
