Skip to content
MCP server

Google Calendar MCP

List, read, create and move Google Calendar events from your coding agent

Runs locallyStatus and history
Pricing
Open source
Platforms
vscode, CLI
Runs
Locally
Version
26.11.14
Listing updated
2 days ago

About Google Calendar MCP

Google Calendar MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Reading is split from writing: two tools list events and fetch one event, and a single admin tool handles every change through named actions. The list tool defaults to your primary calendar from now onward, returns attendees with response status and accepts a text search, so questions like who has not accepted yet are answerable.

The admin actions create, update and delete events and list or create calendars. Deleting needs confirm: true. Updates change the title, times, description and location but not the guest list, and there is no free or busy tool, so availability is answered by listing events in a window. The server cannot accept or decline invitations.

It is a local VS Code extension and npm package (Node.js 22 or newer) using your own Google sign-in, and the page compares it with Google's remote Calendar server, which was in Developer Preview when the page was written.

Install

Run in a terminal

claude mcp add google-calendar-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-calendar-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-calendar-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "google-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Configuration

  • GOOGLE_APPLICATION_CREDENTIALSPath to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables.
  • GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.
  • GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.
  • GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Google Calendar scopes.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

calendar_list_events
List upcoming events with attendees, location and times.
calendar_get_event
Get full details of one event.

What it does

List events
Upcoming events with attendees, location and times, 25 by default.
Event details
Fetch the full detail of one event by ID.
Create and update
Book or change events with optional guests, location and time zone.
Confirmed delete
Deleting an event needs explicit confirmation.
Calendar management
List all calendars or create a new one.
Local runtime
Runs on your machine with no telemetry.

Good for

  • Ask what meetings you have today
  • Book a 30 minute review with named guests
  • Move a planning call to another day
  • Create a release calendar for a project

Pricing

Open source

Free, MIT licensed

Prices change. Check renzojohnson.com before you buy.

Google Calendar MCP FAQ

Can it check free or busy time?

No, it lists events for the window instead.

Can it change the guest list?

No, update_event does not change guests.

Does deleting ask first?

Yes, delete_event only runs with confirm: true.

Is it free?

Yes, it is free and MIT licensed.

Is Google Calendar MCP free?

Yes. Google Calendar MCP is open source, so you can use and self-host it for free.

How do I add Google Calendar MCP to Claude Code?

Run this command in your terminal: claude mcp add google-calendar-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-calendar-mcp

What are the best alternatives to Google Calendar MCP?

The closest alternatives to Google Calendar MCP are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Google Calendar MCP

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media