-
securityA
license-
qualityEnables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.
Last updated -
12
3
MIT License
Provides tools for managing Google Calendar events including listing events within time windows, creating new events with details like summary, start/end times, description and location, and deleting events by summary name.
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.jsondownloaded 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.jsonat 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.jsonandtoken.jsonout of git.Time strings must be RFC3339 with timezone (e.g.,
2025-08-08T00:00:00+06:00).All-day events return a
datestring instead ofdateTime.
This server cannot be installed
Related Resources
Related MCP Servers
- -securityFlicense-qualityEnables 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 -241
- -securityFlicense-qualityEnables 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
- AsecurityAlicenseAqualityProvides comprehensive Google Calendar integration capabilities allowing AI assistants to list, create, update, and delete calendar events through a standardized Model Context Protocol.Last updated -52MIT License