MCP.so
Sign In

Google Calendar MCP Server

@masa1023

Basic information

Category

Productivity

Transports

stdio

Author

masa1023

About Google Calendar MCP Server

No overview available yet

Google Calendar MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-calendar": {
      "command": "python",
      "args": [
        "/full/path/to/google_calendar_server.py"
      ],
      "env": {
        "GOOGLE_TOKEN_FILE": "/path/to/token/file.json"
      }
    }
  }
}

Google Calendar MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Calendar MCP Server?

A Model Context Protocol (MCP) server that provides programmatic access to Google Calendar data. It integrates with any MCP-compatible client (e.g., Claude Desktop) to allow listing calendars, checking available time slots, and retrieving upcoming events. Designed for developers and power users who need to interact with Google Calendar through AI assistants or automated workflows.

How to use Google Calendar MCP Server?

Install the Python dependencies with pip install -r requirements.txt, then run python setup_credentials.py to authenticate with Google. Start the server with python google_calendar_server.py. For use with Claude Desktop, configure the MCP server entry with the full path to the script and set the GOOGLE_TOKEN_FILE environment variable.

Key features of Google Calendar MCP Server

  • List all available Google Calendars.
  • Find available time slots in a calendar.
  • Get upcoming events from a calendar.
  • Configurable search horizon and slot duration.
  • OAuth2-based authentication with Google Calendar API.
  • Works with any MCP-compatible client.

Use cases of Google Calendar MCP Server

  • An AI assistant queries a user’s available meeting slots to schedule a new event.
  • A bot retrieves upcoming events to summarize the day’s schedule.
  • A workflow checks multiple calendars for overlapping availability.
  • A developer builds a custom tool to automate calendar management.

Frequently asked questions

1

What tools does the server expose?

It exposes three tools: `list_calendars` (list all calendars), `get_available_slots` (find free time slots with configurable duration and hour range), and `get_upcoming_events` (fetch upcoming events with a max count).

2

What are the prerequisites?

Python 3.9 or later, a Google Cloud project with the Calendar API enabled, and OAuth2 credentials (client ID and secret).

3

How do I set up authentication?

Run `python setup_credentials.py` and follow the prompts to authenticate with Google. The resulting token is stored in a file specified by the `GOOGLE_TOKEN_FILE` environment variable.

4

How do I configure it with Claude Desktop?

Edit Claude Desktop’s configuration JSON: set the command to `python`, the args to the full path of `google_calendar_server.py`, and provide the `GOOGLE_TOKEN_FILE` environment variable pointing to your token file.

5

Where does authentication data live?

The OAuth2 token is stored locally in the file path given by the `GOOGLE_TOKEN_FILE` environment variable. No external data storage is used.

Comments

More Productivity MCP servers