Hosted Google Calendar MCP
Sign in with Google for free, get a scoped API key, and add one MCP endpoint to Claude Code, Codex, OpenClaw, Hermes, Cursor, or any HTTP client.
$0 to start. No credit card required.
The CalendarMCP setup path
Grant calendar access with free Google OAuth.
Use the $0 bearer token from your dashboard.
Paste the MCP URL into your agent.
Agent setup console
Connect Google Calendar
Copy dashboard key
Paste config into your agent
Terminal
Checking whether you already have an API key.
claude mcp add --transport http calendar https://calendarmcp.ai/api/mcp \ --header "Authorization: Bearer cmcp_your_api_key"
You are connected to CalendarMCP, a hosted Google Calendar MCP server. Use this MCP server for Google Calendar tasks: - MCP server name: calendar - Endpoint: https://calendarmcp.ai/api/mcp - Auth header: Authorization: Bearer cmcp_your_api_key - Agent-readable docs: https://calendarmcp.ai/api/docs - Human docs: https://calendarmcp.ai/docs Operating rules: 1. Call list_calendars first to see available calendars and read/write permissions. 2. Use find_free_time before scheduling anything that depends on availability. 3. Use create_event for new meetings or time blocks. 4. Use update_event or batch_update_events for changes to existing events. 5. Use manage_attendees when only attendee changes are needed. 6. Do not ask the user for Google credentials. The API key already scopes access. 7. If a calendar is read-only, explain that write access must be enabled in the CalendarMCP dashboard.
Endpoint
https://calendarmcp.ai/api/mcp
Docs
https://calendarmcp.ai/api/docs
Transport
Streamable HTTP MCP
Tools
11 calendar tools
Permission boundaries
High-level agent jobs
The user should not need to think in API calls. CalendarMCP gives agents the tools to turn ordinary requests into calendar actions.
Say this to your agent
"Hey agent, add every World Cup game to my calendar."
Turn a schedule into structured events with teams, kickoff times, locations, and reminders.
create_event + batch_update_events
Say this to your agent
"Hey agent, put flight options on my calendar for NYC next month."
Create tentative calendar blocks for candidate flights, hotel windows, and itinerary options.
quick_add_event + create_event
Say this to your agent
"Hey agent, find a clean 90-minute block for investor prep this week."
Check free/busy across work and personal calendars before placing the hold.
find_free_time + create_event
Say this to your agent
"Hey agent, move every recurring standup next week by 30 minutes."
Patch multiple events in one operation instead of making repeated calendar edits.
list_events + batch_update_events
Why CalendarMCP
Update up to 50 events in a single concurrent call.
Query across connected calendars and merge results by time.
Service-account activation flow for users blocked from OAuth.
List, get, create, update, delete, quick add, batch update, free time, attendees, and calendars.
$0 to connect Google Calendar, copy an API key, and test the full setup path. No local Docker or credentials file.
Machine-readable docs, pagination, structured errors, and HTTP MCP support.
Available calendar tools
list_eventsList events in a time range with optional search.get_eventGet full details of a specific event.create_eventCreate events with attendees, reminders, recurrence, and location.update_eventPatch an existing event.delete_eventDelete an event.quick_add_eventCreate an event from natural language text.list_calendarsList all user's calendars.create_calendarCreate a new secondary calendar.find_free_timeQuery free/busy across calendars.manage_attendeesAdd or remove attendees from an existing event.batch_update_eventsUpdate multiple events in one call.