MCP Google Calendar MCP Server

MCP server for interacting with Google Calendar

Local serverstdioTypeScript

What is the MCP Google Calendar MCP server?

Mcp google calendar mcp server lets Claude, Cursor and other MCP clients work with MCP Google Calendar directly. MCP server for interacting with Google Calendar.

What MCP Google Calendar does

A Model Context Protocol (MCP) server that integrates with Google Calendar, built with TypeScript.

Key capabilities

  • Seamless Google Calendar integration with OAuth 2.0 authentication
  • Persistent token storage for automatic authentication
  • List and manage calendars with comprehensive event operations
  • Create, read, update, and delete calendar events
  • Fetch calendar events between specified dates
  • Server-Sent Events (SSE) transport option for real-time updates
  • Simple integration with Claude and other MCP-compatible AI assistants

Tools it exposes

Once connected, the assistant can call these 6 tools directly:

  • list_calendars — Get all available calendars
  • list_calendar_events — Retrieve events between specified dates
  • create_calendar_event — Add a new event to your calendar
  • get_calendar_event — Fetch details for a specific event
  • edit_calendar_event — Modify an existing calendar event
  • delete_calendar_event — Remove an event from your calendar

Installing the mcp google calendar mcp server

The server is distributed via npm as mcp-google-calendar, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Configuration

The server reads one environment variable: CREDENTIALS_PATH. Keep credentials in your client's env block or a secrets manager rather than committing them.

Requirements

  1. Node.js (v16 or higher) 2. Google Cloud Platform account 3. Google Calendar API enabled 4. OAuth 2.0 credentials

Where it fits

Productivity servers pay off through capture: the tasks and notes that never get filed are the ones where opening the app is more friction than the thought is worth. MCP Google Calendar sits in that group, and the shape of its toolset — list_calendars, list_calendar_events, create_calendar_event among others — tells you what it is really for. Worth comparing against the other productivity servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • Maintained by am2rican5, written in TypeScript.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the mcp google calendar mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
list_calendarsGet all available calendars
list_calendar_eventsRetrieve events between specified dates
create_calendar_eventAdd a new event to your calendar
get_calendar_eventFetch details for a specific event
edit_calendar_eventModify an existing calendar event
delete_calendar_eventRemove an event from your calendar

How to install the MCP Google Calendar MCP server

{
   "mcpServers": {
      "mcp-google-calendar": {
         "command": "npx",
         "args": ["-y", "mcp-google-calendar"],
         "env": {
            "CREDENTIALS_PATH": "/path/to/your/credentials.json"
         }
      }
   }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  1. Node.js (v16 or higher) 2. Google Cloud Platform account 3. Google Calendar API enabled 4. OAuth 2.0 credentials
VariableDescriptionRequired
CREDENTIALS_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use MCP Google Calendar to list calendars.
  • Use MCP Google Calendar to list calendar events.
  • Use MCP Google Calendar to create calendar event.

Frequently asked questions

It connects MCP Google Calendar to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (list_calendars, list_calendar_events, create_calendar_event, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Google Calendar directly.