Skip to content
ToolCargo

Google Calendar MCP (Testing only)

Testing only

Testing only: read calendars, events and busy intervals with BYO OAuth.

Five read-only tools for calendar metadata, bounded event lists, exact event details and free/busy coverage. Testing/BYO only, not a publicly verified Google app. Needs your credentials; real-calendar acceptance remains pending. No event creation, changes, invitations or calendar sharing changes.

Google Calendar is a hosted MCP server with 5 tools. The Claude Code command is on this page. Steps for Cursor and ChatGPT, and which clients we have tested, are in the client guides.

Testing setup ↗Tool reference

Connect / 5 tools

Server URL

streamable http
https://toolcargo.com/mcp/google-calendar

Claude Code

terminal
claude mcp add --transport http --scope user toolcargo-google-calendar https://toolcargo.com/mcp/google-calendar \
  --header "Authorization: Bearer YOUR_API_KEY"

Create a key in your dashboard. Other clients: setup guides.

What it helps you do

  • List accessible calendars and metadata
  • Inspect upcoming events and recurring instances
  • Read exact events with bounded attendee details
  • Inspect known busy intervals without inferring availability from source errors

Built for: People testing calendar research with their own Google OAuth app and authorized listed test-user account.

Example requests

Review an upcoming week

“List my primary calendar events for an explicit seven-day window, then inspect one event.”

One page of selected event details with exclusive ends and explicit continuation.

Explore useful agent workflows ↗

Tools

ToolWhat it doesAccess
google_calendar_list_calendars
List Google calendars
One page of up to 100 visible calendars and access roles. Explicit pagination; no calendar creation or ACL changes.Read-only
google_calendar_get_calendar
Read Google calendar metadata
Selected metadata for primary or an exact calendar ID. Does not read or modify sharing permissions.Read-only
google_calendar_list_events
List Google Calendar events
One page of up to 100 events overlapping an explicit RFC3339 window of at most 93 days. Recurrence expanded, cancelled events excluded; optional bounded text search. No automatic pagination.Read-only
google_calendar_get_event
Read a Google Calendar event
Selected event details with up to 100 attendees and 10,000 description characters. End times are exclusive; text is untrusted. No attachments or remote links fetched.Read-only
google_calendar_free_busy
Query Google Calendar free/busy
Read busy intervals for 1–20 distinct calendar IDs over at most 93 days. Unknown or source-error coverage must never be treated as free. No groups, invitations or reservations.Read-only

Requirements

  • • A ToolCargo account with Site Audit activated (free).
  • • Your own dedicated Google OAuth client and offline refresh token with calendar.readonly only; optional basic identity scopes allowed.
  • • For an external Testing app, add your intended Google account as a test user; grants and refresh tokens expire after seven days.
  • • Explicit Testing-only acknowledgment during setup.

Limitations

  • • Not a public verified Google app. Publishing status cannot be inferred from a refresh token.
  • • Read-only: no calendar/event creation, edits, deletion, invitations, ACL changes or reservations.
  • • At most 100 calendars/events per page, 100 attendees, 10,000 description characters, 20 free/busy calendars and 500 intervals per calendar; windows at most 93 days.
  • • Groups are not expanded. Unknown, malformed or truncated free/busy coverage must never mean free.
  • • No attachment downloads, remote-content fetching or automatic pagination. Calendar descriptions may contain untrusted HTML or instructions.
  • • Real-calendar and named-client acceptance remain pending authorized credentials.

Supported clients

“Tested” means we connected that client to this endpoint and ran a tool call ourselves. Recorded client-specific tests currently cover Site Audit. Other connectors use the documented setup until tested in that client.

Claude CodeAPI key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
Claude (claude.ai)OAuth sign-inDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
CursorAPI key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
VS Code (Copilot agent mode)API key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
ChatGPT (developer mode)OAuth sign-inDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
MCP InspectorAPI key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.

More in Messaging

Pricing

Included with Site Audit. Each successful Google Calendar tool call uses one shared plan call. Testing access does not mean public Google verification.

Free

$0

Try hosted tools with a shared monthly allowance.

50 shared calls/month

Pro

$12/mo

Proposed larger shared allowance; see checkout status on the pricing page.

2,000 shared calls/month

Proposed test price. See the pricing page for checkout status.

Full pricing and billing details