How many calendars can one key access?

A single API key can connect multiple Google accounts with merged results.

Is self-hosting available?

The hosted service itself is closed source; the README recommends nspady/google-calendar-mcp for self-hosted use.

CalendarMCP

Verified

Hosted Google Calendar MCP server for AI agents.

MCP ServerSearch & WebRemote (streamable-http)

View on GitHub

Updated 2026-06-16

What is the CalendarMCP MCP server?

CalendarMCP provides a remote MCP endpoint at https://calendarmcp.ai/api/mcp using streamable-http transport. Agents authenticate via Authorization Bearer headers containing the user's API key, enabling multi-account calendar access and batch operations.

The service supports 10 documented tools including event listing, creation, updates, free-time queries, and attendee management. It is designed for clients such as Claude Desktop, Cursor, and other MCP-compatible applications.

Install & connect

Add this to your MCP client config. Pick your client below and copy.

{
  "mcpServers": {
    "server": {
      "url": "https://calendarmcp.ai/api/mcp"
    }
  }
}

Tools it exposes

10 tools your AI client can call once connected.

list_events— List events across one or all connected calendars in a time range. Auto-paginates up to 2500 results.

get_event— Full details of one event.

create_event— Create an event. Supports attendees, location, reminders, recurrence, all-day.

update_event— Partial update of an existing event.

delete_event— Delete an event.

quick_add_event— Create from natural language ("Lunch with Sam Friday 1pm").

list_calendars— List every calendar the API key can see, with per-calendar R/W permissions.

find_free_time— Free/busy query across one or more calendars.

manage_attendees— Add or remove attendees from an event.

batch_update_events— Update up to 50 events in one concurrent call.

Example prompts

Once connected, try asking your AI client:

“What meetings do I have next Tuesday?

“Create a lunch with Sam on Friday at 1pm and invite the team.

“Find free time this week across all my calendars.

“Update the recurring team sync to start 30 minutes later for the next 10 occurrences.

Security & permissions

Requires a remote API key obtained after Google OAuth at calendarmcp.ai; the key grants the server read/write access to connected Google Calendars.

What you can do with CalendarMCP

Schedule management

Ask an agent to list upcoming events or create new ones using natural language.

Conflict prevention

Query free time across calendars before booking to avoid double-booking.

Batch edits

Update multiple recurring events in a single prompt without manual repetition.

How to use CalendarMCP

1Visit calendarmcp.ai and sign in with Google to obtain an API key.
2Add the MCP server URL https://calendarmcp.ai/api/mcp to your client configuration.
3Include the Authorization header with your Bearer API key in the client settings.
4Restart or reload the MCP client to establish the connection.
5Test by asking your agent about calendar events.

CalendarMCP: pros & cons

Pros

+Zero local setup or Docker required
+Supports HTTP transport for hosted clients like Claude.ai and Cursor
+Batch operations and multi-account support under one key
+Works with Google Advanced Protection accounts via service accounts

Cons

–Hosted service is not open source
–API key must be stored in client configuration files
–Requires trusting a third-party hosted endpoint with calendar data

Did you find this helpful?

Frequently asked questions

No, CalendarMCP is fully hosted and accessed via HTTPS.

User reviews

Verified reviews from the community shape this listing's rating.

Loading reviews…

Promote CalendarMCP