Calendar-mcp Server

An MCP server that gives an LLM client read and write access to your Google Calendar. It runs as a single process — stdio by default, streamable HTTP optionally — and exposes 23 tools with…

Local serverstdio

What is the Calendar-mcp Server?

Google Calendar MCP Server (Python) is an MCP project maintained in the deciduus/calendar-mcp repository. The maintainer describes its purpose as “An MCP server that gives an LLM client read and write access to your Google Calendar. It runs as a single process — stdio by…”. Read the project documentation for the complete scope.

Installation

The documented pypi package is calendar-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, TOKEN_FILE_PATH. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_calendarsread
find_eventsread
check_attendee_statusread
query_free_busyread
analyze_busynessread
project_recurring_eventsread
create_calendarwrites
create_eventwrites
quick_add_eventwrites
update_eventwrites
move_eventwrites
add_attendeewrites
respond_to_eventwrites
schedule_mutualwrites
find_focus_timeread
detect_conflictsread
time_auditread
suggest_reschedulewrites (opt-in)
block_focus_timewrites
list_accountsread
get_preferencesread
set_preferenceswrites

How to install the Calendar-mcp Server

{
  "mcpServers": {
    "calendar": {
      "command": "uvx",
      "args": [
        "calendar-mcp-server"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "...",
        "GOOGLE_CLIENT_SECRET": "YOUR_GOOGLE_CLIENT_SECRET",
        "TOKEN_FILE_PATH": "YOUR_TOKEN_FILE_PATH"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GOOGLE_CLIENT_IDDeclared in the maintainer’s client configuration.Yes
GOOGLE_CLIENT_SECRETDeclared in the maintainer’s client configuration.Yes
TOKEN_FILE_PATHDeclared in the maintainer’s client configuration.Check documentation