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

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 -
8
3
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 -
16
1
Google Calendar MCP
Avik-creator
-
security
F
license
-
quality
Enables programmatic management of Google Calendar events through natural language interactions, supporting creation, reading, updating, and deletion of events with features for recurring events, attendees, and reminders.
Last updated -
2
Google Calendar MCP Server
peadams21
A
security
A
license
A
quality
Provides comprehensive Google Calendar integration capabilities allowing AI assistants to list, create, update, and delete calendar events through a standardized Model Context Protocol.
Last updated -
5
3
MIT License

View all related MCP servers

Appeared in Searches

ManicTime - Time Tracking Software

Google Calendar MCP Server