Google Calendar MCP server for AI agents
List, create, change and delete calendar events and check when people are free.
- Auth
- OAuth 2.0 (sign in with the app)
- Tools
- 8
- Triggers
- 0
- Category
- Calendar
Tools and triggers
List calendars
GOOGLECALENDAR_LIST_CALENDARS
Lists the calendars the user can see, with ids, names and the user's access role on each.read-only
List events
GOOGLECALENDAR_LIST_EVENTS
Lists events of a calendar in a time range or matching a text search. Recurring events are expanded and ordered by start time by default.read-only
Get an event
GOOGLECALENDAR_GET_EVENT
Returns one event with its attendees, times, location, recurrence and meeting link.read-only
Create an event
GOOGLECALENDAR_CREATE_EVENT
Creates an event, optionally with guests (who get invitations) and a video-meeting link.
Update an event
GOOGLECALENDAR_UPDATE_EVENT
Changes an event. Only the fields given are changed; a given attendee list replaces the old one.
Create an event from text
GOOGLECALENDAR_QUICK_ADD_EVENT
Creates an event from one sentence such as `Lunch with Sam tomorrow at noon`; Google parses the date and title.
Delete an event
GOOGLECALENDAR_DELETE_EVENT
Deletes an event; guests are notified depending on send_updates.destructive
Check free/busy
GOOGLECALENDAR_FREE_BUSY
Returns the busy time slots of one or more calendars in a range, for finding a free meeting time.read-only
Connect via MCP
Create an MCP server for Google Calendar in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.
claude mcp add --transport http googlecalendar \
"https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
--header "x-api-key: ptm_…"Connect via REST
Run a tool with one request. The response is { data, error, successful, log_id } for every tool.
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/GOOGLECALENDAR_LIST_CALENDARS \
-H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
-d '{ "user_id": "alice", "arguments": {} }'