Google Calendar MCP Server

An MCP server exposing Google Calendar tools to any MCP-compatible client (e.g., Claude Desktop, Cursor MCP CLI). It lets you:

List events in a time window
Create events
Delete events by summary

Prerequisites

Python 3.11+
A Google Cloud project with OAuth 2.0 Client ID (Desktop) for Google Calendar API
credentials.json downloaded locally (do not commit it)

Setup

Clone and install dependencies

uv sync  # or: pip install -e .

Enable Google Calendar API and download OAuth credentials

Go to Google Cloud Console → APIs & Services → Credentials
Create OAuth client ID: Application type "Desktop app"
Download the JSON and save it as credentials.json at the project root

First run / OAuth consent

The first call to any tool will open a browser for consent and produce token.json locally (ignored by git).

Running the MCP server

python -m src.service  # Not the server entry
python main.py         # Starts the MCP over stdio

Use from MCP-compatible clients by pointing to main.py as the command.

Tools

get_google_calendar_events(maxResults, calendarId="primary", singleEvents=True, orderBy="startTime", timeMin=None, timeMax=None)
- Returns a list like: [{ "title": str, "start-time": str, "end-time": str }]
create_google_calendar_event(summary, start: datetime, end: datetime, description=None, location=None, time_zone="Asia/Dhaka")
- Returns the created event HTML link (if available)
delete_google_calendar_event(event_name: str)
- Deletes the first exact summary match

MCP client configuration (example)

Example JSON snippet for a client config:

{
  "mcpServers": {
    "google-calendar": {
      "command": "python",
      "args": ["main.py"],
      "env": {}
    }
  }
}

Notes

Keep credentials.json and token.json out of git.
Time strings must be RFC3339 with timezone (e.g., 2025-08-08T00:00:00+06:00).
All-day events return a date string instead of dateTime.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables interaction with Google Calendar through OAuth 2.0 authentication. Supports listing, creating, and deleting calendar events with timezone handling and RFC3339 date formatting.

Related MCP Servers

Google Workspace MCP Server
aaronsb
-
security
A
license
-
quality
Provides authenticated access to Google Workspace APIs with a focus on Gmail operations and planned Calendar support, featuring secure OAuth authentication and multi-account management with detailed error handling.
Last updated -
86
TypeScript
MIT License
Calendar Tools MCP Server
cablate
-
security
A
license
-
quality
Enables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.
Last updated -
9
2
TypeScript
MIT License
Google Calendar AutoAuth MCP Server
falgom4
-
security
A
license
-
quality
Enables AI assistants to manage Google Calendar through natural language interactions with features like creating, updating, and deleting events, searching calendars, and supporting natural language date/time inputs.
Last updated -
6
1
JavaScript
MIT License
Google Calendar MCP Server
Caue397
-
security
F
license
-
quality
Enables LLMs to read, create, and manage Google Calendar events through a standardized interface, including features like listing calendars, managing events, and processing calendar information from screenshots and images.
Last updated -
31
1
TypeScript

View all related MCP servers

Google Calendar MCP Server