Google Calendar MCP Server

Allows your AI assistant to query, create, and manage calendar events in Google Calendar.

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:

json
{
  "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:

json
{
  "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
Google
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.