MCP.so
Sign In

Google Calendar MCP Server

@masa1023

Repository

About Google Calendar MCP Server

No overview available yet

#google-calendar#mcp-server#calendar-integration

Basic information

Category

Productivity

Runtime

python

Transports

stdio

Publisher

masa1023

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"
      }
    }
  }
}

Tools

No tools detected

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.

FAQ from Google Calendar MCP Server

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).

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).

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.

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.

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

Desktop Commander MCP

wonderwhy-er

This is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities

6.3K

AppleScript MCP Server (Dual access: python and node.js)

peakmojo

MCP server that execute applescript giving you full control of your Mac

461

TickTick MCP Server

alexarevalo9

A Model Context Protocol (MCP) server designed to integrate with the TickTick task management platform, enabling intelligent context-aware task operations and automation.

71

MCP Shrimp Task Manager

cjo4m06

Shrimp Task Manager is a task tool built for AI Agents, emphasizing chain-of-thought, reflection, and style consistency. It converts natural language into structured dev tasks with dependency tracking and iterative refinement, enabling agent-like developer behavior in reasoning A

2.1K

MCP Google Calendar Server

markelaugust74

A Model Context Protocol (MCP) server implementation for Google Calendar integration. Create and manage calendar events directly through Claude or other AI assistants.

32