Google Calendar Automation via Rube MCP
Automate Google Calendar workflows including event creation, scheduling, availability checks, attendee management, and calendar browsing through Composio's Google Calendar toolkit.
Toolkit docs: composio.dev/toolkits/googlecalendar
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Google Calendar connection via
RUBE_MANAGE_CONNECTIONS with toolkit googlecalendar
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit googlecalendar
- If connection is not ACTIVE, follow the returned auth link to complete Google OAuth
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Create and Manage Events
When to use: User wants to create, update, or delete calendar events
Tool sequence:
GOOGLECALENDAR_LIST_CALENDARS - Identify target calendar ID [Prerequisite]
GOOGLECALENDAR_GET_CURRENT_DATE_TIME - Get current time with proper timezone [Optional]
GOOGLECALENDAR_FIND_FREE_SLOTS - Check availability before booking [Optional]
GOOGLECALENDAR_CREATE_EVENT - Create the event [Required]
GOOGLECALENDAR_PATCH_EVENT - Update specific fields of an existing event [Alternative]
GOOGLECALENDAR_UPDATE_EVENT - Full replacement update of an event [Alternative]
GOOGLECALENDAR_DELETE_EVENT - Delete an event [Optional]
Key parameters:
calendar_id: Use 'primary' for main calendar, or specific calendar ID
start_datetime: ISO 8601 format 'YYYY-MM-DDTHH:MM:SS' (NOT natural language)
timezone: IANA timezone name (e.g., 'America/New_York', NOT 'EST' or 'PST')
event_duration_hour: Hours (0+)
event_duration_minutes: Minutes (0-59 only; NEVER use 60+)
summary: Event title
attendees: Array of email addresses (NOT names)
location: Free-form text for event location
Pitfalls:
start_datetime must be ISO 8601; natural language like 'tomorrow' is rejected
event_duration_minutes max is 59; use event_duration_hour=1 instead of event_duration_minutes=60
timezone must be IANA identifier; abbreviations like 'EST', 'PST' are NOT valid
attendees only accepts email addresses, not names; resolve names first
- Google Meet link creation defaults to true; may fail on personal Gmail accounts (graceful fallback)
- Organizer is auto-added as attendee unless
exclude_organizer=true
2. List and Search Events
When to use: User wants to find or browse events on their calendar
Tool sequence:
GOOGLECALENDAR_LIST_CALENDARS - Get available calendars [Prerequisite]
GOOGLECALENDAR_FIND_EVENT - Search by title/keyword with time bounds [Required]
GOOGLECALENDAR_EVENTS_LIST - List events in a time range [Alternative]
GOOGLECALENDAR_EVENTS_INSTANCES - List instances of a recurring event [Optional]
Key parameters:
query / q: Free-text search (matches summary, description, location, attendees)
timeMin: Lower bound (RFC3339 with timezone offset, e.g., '2024-01-01T00:00:00-08:00')
timeMax: Upper bound (RFC3339 with timezone offset)
singleEvents: true to expand recurring events into instances
orderBy: 'startTime' (requires singleEvents=true) or 'updated'
maxResults: Results per page (max 2500)
Pitfalls:
- Timezone warning: UTC timestamps (ending in 'Z') don't align with local dates; use local timezone offsets instead
- Example: '2026-01-19T00:00:00Z' covers 2026-01-18 4pm to 2026-01-19 4pm in PST
- Omitting
timeMin/timeMax scans the full calendar and can be slow
pageToken in response means more results; paginate until absent
orderBy='startTime' requires singleEvents=true
3. Manage Attendees and Invitations
When to use: User wants to add, remove, or update event attendees
Tool sequence:
GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST - Find the event [Prerequisite]
GOOGLECALENDAR_PATCH_EVENT - Add attendees (replaces entire attendees list) [Required]
GOOGLECALENDAR_REMOVE_ATTENDEE - Remove a specific attendee by email [Required]
Key parameters:
event_id: Unique event identifier (opaque string, NOT the event title)
attendees: Full list of attendee emails (PATCH replaces entire list)
attendee_email: Email to remove
send_updates: 'all', 'externalOnly', or 'none'
Pitfalls:
event_id is a technical identifier, NOT the event title; always search first to get the ID
PATCH_EVENT attendees field replaces the entire list; include existing attendees to avoid removing them
- Attendee names cannot be resolved; always use email addresses
- Use
GMAIL_SEARCH_PEOPLE to resolve names to emails before managing attendees
4. Check Availability and Free/Busy Status
When to use: User wants to find available time slots or check busy periods
Tool sequence:
GOOGLECALENDAR_LIST_CALENDARS - Identify calendars to check [Prerequisite]
GOOGLECALENDAR_GET_CURRENT_DATE_TIME - Get current time with timezone [Optional]
GOOGLECALENDAR_FIND_FREE_SLOTS - Find free intervals across calendars [Required]
GOOGLECALENDAR_FREE_BUSY_QUERY - Get raw busy periods for computing gaps [Fallback]
GOOGLECALENDAR_CREATE_EVENT - Book a confirmed slot [Required]
Key parameters:
items: List of calendar IDs to check (e.g., ['primary'])
time_min/time_max: Query interval (defaults to current day if omitted)
timezone: IANA timezone for interpreting naive timestamps
calendarExpansionMax: Max calendars (1-50)
groupExpansionMax: Max members per group (1-100)
Pitfalls:
- Maximum span ~90 days per Google Calendar freeBusy API limit
- Very long ranges or inaccessible calendars yield empty/invalid results
- Only calendars with at least freeBusyReader access are visible
- Free slots responses may normalize to UTC ('Z'); check offsets
GOOGLECALENDAR_FREE_BUSY_QUERY requires RFC3339 timestamps with timezone
Common Patterns
ID Resolution
- Calendar name -> calendar_id:
GOOGLECALENDAR_LIST_CALENDARS to enumerate all calendars
- Event title -> event_id:
GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST
- Attendee name -> email:
GMAIL_SEARCH_PEOPLE
Timezone Handling
- Always use IANA timezone identifiers (e.g., 'America/Los_Angeles')
- Use
GOOGLECALENDAR_GET_CURRENT_DATE_TIME to get current time in user's timezone
- When querying events for a local date, use timestamps with local offset, NOT UTC
- Example: '2026-01-19T00:00:00-08:00' for PST, NOT '2026-01-19T00:00:00Z'
Pagination
GOOGLECALENDAR_EVENTS_LIST returns nextPageToken; iterate until absent
GOOGLECALENDAR_LIST_CALENDARS also paginates; use page_token
Known Pitfalls
- Natural language dates: NOT supported; all dates must be ISO 8601 or RFC3339
- Timezone mismatch: UTC timestamps don't align with local dates for filtering
- Duration limits:
event_duration_minutes max 59; use hours for longer durations
- IANA timezones only: 'EST', 'PST', etc. are NOT valid; use 'America/New_York'
- Event IDs are opaque: Always search to get event_id; never guess or construct
- Attendees as emails: Names cannot be used; resolve with GMAIL_SEARCH_PEOPLE
- PATCH replaces attendees: Include all desired attendees in the array, not just new ones
- Conference limitations: Google Meet may fail on personal accounts (graceful fallback)
- Rate limits: High-volume searches can trigger 403/429; throttle between calls
Quick Reference
| Task |
Tool Slug |
Key Params |
| List calendars |
GOOGLECALENDAR_LIST_CALENDARS |
max_results |
| Create event |
GOOGLECALENDAR_CREATE_EVENT |
start_datetime, timezone, summary |
| Update event |
GOOGLECALENDAR_PATCH_EVENT |
calendar_id, event_id, fields to update |
| Delete event |
GOOGLECALENDAR_DELETE_EVENT |
calendar_id, event_id |
| Search events |
GOOGLECALENDAR_FIND_EVENT |
query, timeMin, timeMax |
| List events |
GOOGLECALENDAR_EVENTS_LIST |
calendarId, timeMin, timeMax |
| Recurring instances |
GOOGLECALENDAR_EVENTS_INSTANCES |
calendarId, eventId |
| Find free slots |
GOOGLECALENDAR_FIND_FREE_SLOTS |
items, time_min, time_max, timezone |
| Free/busy query |
GOOGLECALENDAR_FREE_BUSY_QUERY |
timeMin, timeMax, items |
| Remove attendee |
GOOGLECALENDAR_REMOVE_ATTENDEE |
event_id, attendee_email |
| Get current time |
GOOGLECALENDAR_GET_CURRENT_DATE_TIME |
timezone |
| Get calendar |
GOOGLECALENDAR_GET_CALENDAR |
calendar_id |
Powered by Composio
Source: davepoon/buildwithclaude → plugins/all-skills/skills/google-calendar-automation/SKILL.md
1---
2name: google-calendar-automation-2
3description: "Automate Google Calendar events, scheduling, availability checks, and attendee management via Rube MCP (Composio). Create events, find free slots, manage attendees, and list calendars programmatically."
4category: productivity-and-workflow
5source_repo: davepoon/buildwithclaude
6source_path: "plugins/all-skills/skills/google-calendar-automation/SKILL.md"
7source_url: https://github.com/davepoon/buildwithclaude/blob/HEAD/plugins/all-skills/skills/google-calendar-automation/SKILL.md
8metadata:
9 source: https://skillmd.com/skills/davepoon/google-calendar-automation-2
10---
11
12
13# Google Calendar Automation via Rube MCP
14
15Automate Google Calendar workflows including event creation, scheduling, availability checks, attendee management, and calendar browsing through Composio's Google Calendar toolkit.
16
17**Toolkit docs**: [composio.dev/toolkits/googlecalendar](https://composio.dev/toolkits/googlecalendar)
18
19## Prerequisites
20
21- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
22- Active Google Calendar connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `googlecalendar`
23- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas
24
25## Setup
26
27**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
28
29
301. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
312. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `googlecalendar`
323. If connection is not ACTIVE, follow the returned auth link to complete Google OAuth
334. Confirm connection status shows ACTIVE before running any workflows
34
35## Core Workflows
36
37### 1. Create and Manage Events
38
39**When to use**: User wants to create, update, or delete calendar events
40
41**Tool sequence**:
421. `GOOGLECALENDAR_LIST_CALENDARS` - Identify target calendar ID [Prerequisite]
432. `GOOGLECALENDAR_GET_CURRENT_DATE_TIME` - Get current time with proper timezone [Optional]
443. `GOOGLECALENDAR_FIND_FREE_SLOTS` - Check availability before booking [Optional]
454. `GOOGLECALENDAR_CREATE_EVENT` - Create the event [Required]
465. `GOOGLECALENDAR_PATCH_EVENT` - Update specific fields of an existing event [Alternative]
476. `GOOGLECALENDAR_UPDATE_EVENT` - Full replacement update of an event [Alternative]
487. `GOOGLECALENDAR_DELETE_EVENT` - Delete an event [Optional]
49
50**Key parameters**:
51- `calendar_id`: Use 'primary' for main calendar, or specific calendar ID
52- `start_datetime`: ISO 8601 format 'YYYY-MM-DDTHH:MM:SS' (NOT natural language)
53- `timezone`: IANA timezone name (e.g., 'America/New_York', NOT 'EST' or 'PST')
54- `event_duration_hour`: Hours (0+)
55- `event_duration_minutes`: Minutes (0-59 only; NEVER use 60+)
56- `summary`: Event title
57- `attendees`: Array of email addresses (NOT names)
58- `location`: Free-form text for event location
59
60**Pitfalls**:
61- `start_datetime` must be ISO 8601; natural language like 'tomorrow' is rejected
62- `event_duration_minutes` max is 59; use `event_duration_hour=1` instead of `event_duration_minutes=60`
63- `timezone` must be IANA identifier; abbreviations like 'EST', 'PST' are NOT valid
64- `attendees` only accepts email addresses, not names; resolve names first
65- Google Meet link creation defaults to true; may fail on personal Gmail accounts (graceful fallback)
66- Organizer is auto-added as attendee unless `exclude_organizer=true`
67
68### 2. List and Search Events
69
70**When to use**: User wants to find or browse events on their calendar
71
72**Tool sequence**:
731. `GOOGLECALENDAR_LIST_CALENDARS` - Get available calendars [Prerequisite]
742. `GOOGLECALENDAR_FIND_EVENT` - Search by title/keyword with time bounds [Required]
753. `GOOGLECALENDAR_EVENTS_LIST` - List events in a time range [Alternative]
764. `GOOGLECALENDAR_EVENTS_INSTANCES` - List instances of a recurring event [Optional]
77
78**Key parameters**:
79- `query` / `q`: Free-text search (matches summary, description, location, attendees)
80- `timeMin`: Lower bound (RFC3339 with timezone offset, e.g., '2024-01-01T00:00:00-08:00')
81- `timeMax`: Upper bound (RFC3339 with timezone offset)
82- `singleEvents`: true to expand recurring events into instances
83- `orderBy`: 'startTime' (requires singleEvents=true) or 'updated'
84- `maxResults`: Results per page (max 2500)
85
86**Pitfalls**:
87- **Timezone warning**: UTC timestamps (ending in 'Z') don't align with local dates; use local timezone offsets instead
88- Example: '2026-01-19T00:00:00Z' covers 2026-01-18 4pm to 2026-01-19 4pm in PST
89- Omitting `timeMin`/`timeMax` scans the full calendar and can be slow
90- `pageToken` in response means more results; paginate until absent
91- `orderBy='startTime'` requires `singleEvents=true`
92
93### 3. Manage Attendees and Invitations
94
95**When to use**: User wants to add, remove, or update event attendees
96
97**Tool sequence**:
981. `GOOGLECALENDAR_FIND_EVENT` or `GOOGLECALENDAR_EVENTS_LIST` - Find the event [Prerequisite]
992. `GOOGLECALENDAR_PATCH_EVENT` - Add attendees (replaces entire attendees list) [Required]
1003. `GOOGLECALENDAR_REMOVE_ATTENDEE` - Remove a specific attendee by email [Required]
101
102**Key parameters**:
103- `event_id`: Unique event identifier (opaque string, NOT the event title)
104- `attendees`: Full list of attendee emails (PATCH replaces entire list)
105- `attendee_email`: Email to remove
106- `send_updates`: 'all', 'externalOnly', or 'none'
107
108**Pitfalls**:
109- `event_id` is a technical identifier, NOT the event title; always search first to get the ID
110- `PATCH_EVENT` attendees field replaces the entire list; include existing attendees to avoid removing them
111- Attendee names cannot be resolved; always use email addresses
112- Use `GMAIL_SEARCH_PEOPLE` to resolve names to emails before managing attendees
113
114### 4. Check Availability and Free/Busy Status
115
116**When to use**: User wants to find available time slots or check busy periods
117
118**Tool sequence**:
1191. `GOOGLECALENDAR_LIST_CALENDARS` - Identify calendars to check [Prerequisite]
1202. `GOOGLECALENDAR_GET_CURRENT_DATE_TIME` - Get current time with timezone [Optional]
1213. `GOOGLECALENDAR_FIND_FREE_SLOTS` - Find free intervals across calendars [Required]
1224. `GOOGLECALENDAR_FREE_BUSY_QUERY` - Get raw busy periods for computing gaps [Fallback]
1235. `GOOGLECALENDAR_CREATE_EVENT` - Book a confirmed slot [Required]
124
125**Key parameters**:
126- `items`: List of calendar IDs to check (e.g., ['primary'])
127- `time_min`/`time_max`: Query interval (defaults to current day if omitted)
128- `timezone`: IANA timezone for interpreting naive timestamps
129- `calendarExpansionMax`: Max calendars (1-50)
130- `groupExpansionMax`: Max members per group (1-100)
131
132**Pitfalls**:
133- Maximum span ~90 days per Google Calendar freeBusy API limit
134- Very long ranges or inaccessible calendars yield empty/invalid results
135- Only calendars with at least freeBusyReader access are visible
136- Free slots responses may normalize to UTC ('Z'); check offsets
137- `GOOGLECALENDAR_FREE_BUSY_QUERY` requires RFC3339 timestamps with timezone
138
139## Common Patterns
140
141### ID Resolution
142- **Calendar name -> calendar_id**: `GOOGLECALENDAR_LIST_CALENDARS` to enumerate all calendars
143- **Event title -> event_id**: `GOOGLECALENDAR_FIND_EVENT` or `GOOGLECALENDAR_EVENTS_LIST`
144- **Attendee name -> email**: `GMAIL_SEARCH_PEOPLE`
145
146### Timezone Handling
147- Always use IANA timezone identifiers (e.g., 'America/Los_Angeles')
148- Use `GOOGLECALENDAR_GET_CURRENT_DATE_TIME` to get current time in user's timezone
149- When querying events for a local date, use timestamps with local offset, NOT UTC
150- Example: '2026-01-19T00:00:00-08:00' for PST, NOT '2026-01-19T00:00:00Z'
151
152### Pagination
153- `GOOGLECALENDAR_EVENTS_LIST` returns `nextPageToken`; iterate until absent
154- `GOOGLECALENDAR_LIST_CALENDARS` also paginates; use `page_token`
155
156## Known Pitfalls
157
158- **Natural language dates**: NOT supported; all dates must be ISO 8601 or RFC3339
159- **Timezone mismatch**: UTC timestamps don't align with local dates for filtering
160- **Duration limits**: `event_duration_minutes` max 59; use hours for longer durations
161- **IANA timezones only**: 'EST', 'PST', etc. are NOT valid; use 'America/New_York'
162- **Event IDs are opaque**: Always search to get event_id; never guess or construct
163- **Attendees as emails**: Names cannot be used; resolve with GMAIL_SEARCH_PEOPLE
164- **PATCH replaces attendees**: Include all desired attendees in the array, not just new ones
165- **Conference limitations**: Google Meet may fail on personal accounts (graceful fallback)
166- **Rate limits**: High-volume searches can trigger 403/429; throttle between calls
167
168## Quick Reference
169
170| Task | Tool Slug | Key Params |
171|------|-----------|------------|
172| List calendars | `GOOGLECALENDAR_LIST_CALENDARS` | `max_results` |
173| Create event | `GOOGLECALENDAR_CREATE_EVENT` | `start_datetime`, `timezone`, `summary` |
174| Update event | `GOOGLECALENDAR_PATCH_EVENT` | `calendar_id`, `event_id`, fields to update |
175| Delete event | `GOOGLECALENDAR_DELETE_EVENT` | `calendar_id`, `event_id` |
176| Search events | `GOOGLECALENDAR_FIND_EVENT` | `query`, `timeMin`, `timeMax` |
177| List events | `GOOGLECALENDAR_EVENTS_LIST` | `calendarId`, `timeMin`, `timeMax` |
178| Recurring instances | `GOOGLECALENDAR_EVENTS_INSTANCES` | `calendarId`, `eventId` |
179| Find free slots | `GOOGLECALENDAR_FIND_FREE_SLOTS` | `items`, `time_min`, `time_max`, `timezone` |
180| Free/busy query | `GOOGLECALENDAR_FREE_BUSY_QUERY` | `timeMin`, `timeMax`, `items` |
181| Remove attendee | `GOOGLECALENDAR_REMOVE_ATTENDEE` | `event_id`, `attendee_email` |
182| Get current time | `GOOGLECALENDAR_GET_CURRENT_DATE_TIME` | `timezone` |
183| Get calendar | `GOOGLECALENDAR_GET_CALENDAR` | `calendar_id` |
184
185---
186*Powered by [Composio](https://composio.dev)*
187
188---
189
190**Source:** [`davepoon/buildwithclaude`](https://github.com/davepoon/buildwithclaude) → `plugins/all-skills/skills/google-calendar-automation/SKILL.md`