playbooks

home / mcp / google calendar mcp server

Google Calendar MCP Server

Provides MCP stdio access to Google Calendar with methods to list, view, create, update, delete events and find free slots.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "anbyounghyun-google_calendar_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<google_calendar_mcp_path>",
        "run",
        "google_calendar_mcp"
      ]
    }
  }
}

You can integrate Google Calendar with an MCP stdio server to query, create, and inspect events using MCP methods. This setup authenticates with Google OAuth2 and bridges Google Calendar data to MCP clients, enabling streamlined calendar management from your MCP tooling.

How to use

Use an MCP client to connect to the Google Calendar MCP server via the stdio interface. You will access a set of MCP methods to list events for a month, list events for a specific day, view event details, create new events (with optional invitees by email), update or delete existing events, and find free time slots on a given date. The server handles Google OAuth2 authentication so you can securely access your calendars.

How to install

Prerequisites you need before installation: Node.js is not required for this flow; you will use the MCP tool uv to run the stdio server. Ensure uv is installed on your system.

Step 1: Install uv (one-time). On macOS or Linux you can run either of these commands.

# macOS/Homebrew
brew install uv

# Or official install script
curl -Ls https://astral.sh/uv/install.sh | sh

Step 2: Install the MCP package you will run with uv. Clone the project and enter its directory.

git clone https://github.com/AnByoungHyun/google_calendar_mcp.git
cd google_calendar_mcp

Step 3: Install the required packages. Run this single command to install all dependencies.

uv sync
``

Configuration and example cursor setup

Register the MCP server with your cursor by adding an entry under the mcpServers section. Use the following example as a reference. This assumes you place the Google Calendar MCP in a known path and name the MCP entry google_calendar_mcp.

{
  "mcpServers": {
    "google_calendar": {
      "command": "uv",
      "args": ["--directory", "<google_calendar_mcp_path>", "run", "google_calendar_mcp"]
    }
  }
}

Additional notes

No virtual environment setup is required. uv creates a safe runtime environment for you. If you have questions during install or run, reach out for help.

Available tools

list_month_events

Fetches all events for a specified year and month.

list_day_events

Fetches all events for a specific day.

get_event_detail

Retrieves detailed information for an event by its ID.

create_event

Creates a new event, with optional attendee emails.

update_event

Updates an existing event by ID (title, time, etc.).

delete_event

Deletes an event by ID.

find_free_slots

Finds free time slots of a specified duration on a given date.