Google Calendar MCP Server
Allows your AI assistant to query, create, and manage calendar events in Google Calendar.
- Skill Road
- Google Calendar MCP Server
Categories
Description
The Google Calendar MCP Server is a highly innovative implementation of the Model Context Protocol (MCP) that allows artificial intelligences (such as Claude Desktop, Cursor, ChatGPT, or Claude Code) to directly access and manage your Google Calendar. Instead of manually copying schedule details, searching emails for free times, or typing in appointments, this server exposes a standardized set of tools directly to your AI assistant. This empowers the AI to independently search for free slots, schedule new meetings, update existing invitations, or detect scheduling conflicts — all handled through simple, natural language.
What is the Google Calendar MCP Server
The Model Context Protocol (MCP) is an open specification that unifies how AI models interact with external tools and systems. The Google Calendar MCP Server serves as a local gateway connecting your AI client to the official Google Calendar REST API. Thanks to the structured tool definitions provided by the server, the AI automatically knows when to query your calendar. For example, if a user says: "Schedule a sync with Sarah for tomorrow at 2 PM," the AI checks availability via the server, validates the input, and executes the event creation tool seamlessly.
Features: Calendar Management via AI
According to developer documentation, the server exposes several key tools for managing calendar events:
List Events: Search and list calendar entries for specific periods to review upcoming tasks or meetings.
Create Event: Schedule new appointments with fields for title, description, start and end times, location, and guest email addresses.
Update Event: Modify existing entries, reschedule meetings, or add/remove guests directly inside the chat.
Delete Event: Cancel or remove outdated calendar entries with simple conversational commands.
Availability Checks: Inspect free/busy slots to automate scheduling across multiple participants.
Configuration and Setup
The setup typically requires running a local Node.js or Python-based service authenticated with Google Cloud Platform credentials.
A common and modern way to execute the server locally using the Python uv runner is:
{
"mcpServers": {
"google-calendar": {
"command": "uvx",
"args": ["mcp-google-calendar"]
}
}
}
To authorize access, navigate to the Google Cloud Console, enable the Google Calendar API for your project, and create OAuth credentials (Desktop Application) or a Service Account. Download the JSON key file to allow your local server to authenticate securely with Google's API.
Security and API Permissions
Calendar data is highly personal, making security and privacy paramount. Since the server runs locally on your machine, your private events and credentials travel directly between your computer and Google's official API endpoints, completely avoiding third-party exposure. It is recommended to apply the principle of least privilege by restricting GCP credentials to the necessary calendar scopes. Implementing confirmation boundaries (Confirmation Guards) is also advised to prevent the AI from accidentally deleting or bulk-creating calendar events without your explicit consent.
Benefits and Evaluation
The Google Calendar MCP Server transforms how professionals manage their daily schedule. It effectively upgrades your AI assistant into an autonomous secretary capable of parsing complex text or email threads and converting them into structured, verified calendar invites. This eliminates administrative overhead and avoids manual entry mistakes.
Requirements
Not recorded yet.
Installation instructions
This guide walks you through setting up the Google Calendar MCP Server step by step. You will learn how to configure the necessary API permissions in the Google Cloud Console and set up the server locally in your AI client.
Step 1: Set Up a Google Cloud Project
To interact with the Google Calendar API, you must create a GCP project:
Log into the [Google Cloud Console](https://console.cloud.google.com/).
Create a new project or select an existing one.
Search for the Google Calendar API and click Enable.
Step 2: Create API Credentials (OAuth 2.0)
For personal everyday use, OAuth authentication is the most straightforward option:
Navigate to APIs & Services > Credentials.
Click Create Credentials > OAuth client ID.
Select Desktop App as the application type, name it (e.g., "Calendar MCP"), and click Create.
Download the credentials JSON and rename it to credentials.json.
Step 3: Configure Claude Desktop
Add the server process inside your local configuration file.
### Using the Python Version via uv:
Add the server entry to your claude_desktop_config.json and point it to your credentials path:
{
"mcpServers": {
"google-calendar": {
"command": "uvx",
"args": [
"mcp-google-calendar",
"--credentials",
"/path/to/your/credentials.json"
]
}
}
}
Save the file and restart Claude Desktop. During the first launch, a secure Google login window will prompt you to authorize access once.
Step 4: Test Your Calendar Tools
Once the server is active, test its capabilities with prompts like these:
"Read my calendar entries for today."
"Schedule a one-hour meeting with Max tomorrow at 2 PM."
"Do I have any free slots on Friday between 10 AM and noon?"
Authentication
Not recorded yet.
Required access permissions
Not recorded yet.
Transmitted or stored data
Not recorded yet.
Security risks
Not recorded yet.
License and costs
- License
- MIT
- Cost
- free
Alternatives
Not recorded yet.
At a glance
- Provider
- Status
- Community
- Deployment
- Local
- Current version
- Not recorded yet.
- GitHub stars
- 1,013
- Last reviewed
- 09.09.2026
Repository and documentation
Categories
Supported clients
Related guides
Guides and background related to this entry.
No related guides yet.