Advertise
MCP.so
Sign In

Google Calendar MCP Server (Python)

@deciduus

Repository

Basic information

Category

Productivity

Last updated

License

NOASSERTION

Transports

stdio

Author

deciduus

About Google Calendar MCP Server

This project implements a Python-based MCP (Model Context Protocol) server that acts as an interface between Large Language Models (LLMs) and the Google Calendar API. It enables LLMs to perform calendar operations via natural language requests.

Google Calendar MCP Server config

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

{
  "mcpServers": {
    "calendar-mcp": {
      "command": "python",
      "args": [
        "run_server.py"
      ]
    }
  }
}

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 (Python)?

A Python-based MCP (Model Context Protocol) server that acts as an interface between Large Language Models and the Google Calendar API. It enables LLMs to perform calendar operations via natural language requests. Secure OAuth 2.0 authentication is built in. For users who want to manage Google Calendar through AI assistants.

How to use Google Calendar MCP Server (Python)?

Requires Python 3.8+, Git, a Google Cloud project with the Calendar API enabled, and OAuth 2.0 Desktop app credentials. Set up a .env file with your Client ID, Client Secret, token file path, and optionally the callback port. Install dependencies with pip install -r requirements.txt. Run python run_server.py once for initial OAuth authentication; after that, the MCP client launches the server automatically. Configure your MCP client (e.g., Cursor/Claude Desktop) via an mcp.json entry that provides the full absolute path to run_server.py as the command argument.

Key features of Google Calendar MCP Server (Python)

  • Secure Google Calendar API access via OAuth 2.0 with automatic token storage/refresh.
  • List, create, update, and delete calendars.
  • Find events with basic and advanced filtering.
  • Create detailed events and quick-add events from text.
  • Add and check attendee response status.
  • Query free/busy information for multiple calendars.
  • Schedule mutual free slots automatically and analyze daily busyness.

Use cases of Google Calendar MCP Server (Python)

  • Schedule meetings by asking an LLM to find free slots across multiple calendars.
  • Check attendee availability and response status without manual calendar browsing.
  • Add or update events, delete events, and manage attendees via natural language.
  • Analyze daily event counts and durations to optimize your schedule.
  • Quickly add events from plain text descriptions (e.g., “Lunch with John tomorrow at noon”).

Frequently asked questions

1

What authentication method does the server use?

It uses the Google OAuth 2.0 Desktop App flow. The server automatically stores and refreshes tokens after the first authorization.

2

How do I configure my MCP client to use this server?

After initial authentication, add a JSON entry to your client’s settings (e.g., `mcp.json`). Set `command` to the full path of your Python executable and `args` to the full absolute path of `run_server.py`. Credentials remain in the `.env` file, not in the client config.

3

Where are my credentials and tokens stored?

Your Google Client ID and Client Secret are stored in the `.env` file in the project root. OAuth tokens are saved to the file specified by `TOKEN_FILE_PATH` (default `.gcp-saved-tokens.json`). Both files should be kept secure and are typically added to `.gitignore`.

4

What Google Calendar permissions does the server need?

By default, the server requests read/write access to the Calendar API (`https://www.googleapis.com/auth/calendar`). You can set `CALENDAR_SCOPES` to read-only if needed.

5

Can I test the server without an MCP client?

Yes. After the initial authentication, running `python run_server.py` starts a FastAPI server (e.g., on `http://localhost:8000`) that you can test with tools like `curl` or Postman. For routine use, the MCP client handles launching.

Comments

More Productivity MCP servers

Dadan MCP

Dadan-io

dadan-sdk-integration is an SDK for integrating Dadan features into React applications. It allows you to add video recording and file selection functionality directly into your React components, providing a seamless user

AgentGrid.io (by Anima)

Anima

Shared workspace for humans and AI agents by Anima. Create, version, publish, and share live apps, docs, and files from any agent, with per-agent access control. Support all types of agents: Grok Bot, Muse AI, OpenAI Dot

Local MCP (LMCP)

lanchuske

Local tools that let your AI use Mail, Calendar, Contacts, Teams, Slack, WhatsApp, OneDrive, Google Drive, Notion, Outlook and Office files on Mac and Windows. Runs on your computer.

54

ContentIn for Agents

ContentIn

Give your AI agent your LinkedIn voice, your own material, what worked on your account and ICP-scored leads. Schedule and publish through LinkedIn's official API. You confirm every post.

EQIQs

EQIQs

EQIQs brings working-style and compatibility insights into Claude. Managers and coaches can take or send a short assessment, compare two people, get a read on a team of up to 12, prepare for meetings with tips that fit t

1
Advertise