Skip to content
MCP server

Google Calendar

MCP server for Google Calendar integration with service account support and domain-wide…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.0.13
Listing updated
4 days ago

About Google Calendar

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

MCP server for Google Calendar integration with service account support and domain-wide delegation.

Install

Run in a terminal

claude mcp add google-calendar --env GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL='<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>' --env GCAL_SERVICE_ACCOUNT_PRIVATE_KEY='<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>' --env GCAL_IMPERSONATE_EMAIL='<GCAL_IMPERSONATE_EMAIL>' -- npx -y google-calendar-workspace-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>"
      }
    }
  }
}

Configuration

  • GCAL_SERVICE_ACCOUNT_CLIENT_EMAILService account email address from Google Cloud Console.Required
  • GCAL_SERVICE_ACCOUNT_PRIVATE_KEYService account private key in PEM format from Google Cloud Console.Required
  • GCAL_IMPERSONATE_EMAILEmail address of the user whose calendar to access via domain-wide delegation.Required
  • ENABLED_TOOLGROUPSComma-separated list of tool groups to enable (readonly or readwrite).

Pricing

Open source

Google Calendar FAQ

Is Google Calendar free?

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

How do I add Google Calendar to Claude Code?

Run this command in your terminal: claude mcp add google-calendar --env GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL='<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>' --env GCAL_SERVICE_ACCOUNT_PRIVATE_KEY='<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>' --env GCAL_IMPERSONATE_EMAIL='<GCAL_IMPERSONATE_EMAIL>' -- npx -y google-calendar-workspace-mcp-server

What are the best alternatives to Google Calendar?

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

Alternatives to Google Calendar

  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