mcpbeat Sign in

Google Calendar MCP Server

local only

Google Calendar runs on your own machine — the client starts it, so there is no endpoint to ping. 144 installs a week from npm. Last commit 30 Aug 2026.

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

Installs per day peak 27 · avg 11 · -34% w/w
a month agotoday
144
Installs / week
npm · google-calendar-workspace-mcp-server
81
Stars
27 open issues
30 Aug 2026
Last commit
no releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 3 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] shared/utils/calendar-helpers.js:1, [пакет] shared/tools/create-event.js:1, [пакет] shared/tools/delete-event.js:1 и ещё 10
этот файл ставится пользователю, но в репозитории его нет

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add google-calendar -e 'GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL=<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>' -e 'GCAL_SERVICE_ACCOUNT_PRIVATE_KEY=<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>' -e 'GCAL_IMPERSONATE_EMAIL=<GCAL_IMPERSONATE_EMAIL>' -- npx -y google-calendar-workspace-mcp-server
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.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>" }
.cursor/mcp.json
{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "google-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_IMPERSONATE_EMAIL": "<GCAL_IMPERSONATE_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "<GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL>",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "<GCAL_SERVICE_ACCOUNT_PRIVATE_KEY>"
      }
    }
  }
}

Put your own values in place of <GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL> (Service account email address from Google Cloud Console), <GCAL_SERVICE_ACCOUNT_PRIVATE_KEY> (Service account private key in PEM format from Google Cloud Console), <GCAL_IMPERSONATE_EMAIL> (Email address of the user whose calendar to access via domain-wide delegation). The author’s registry entry marks them as required.

Optional settings from the registry entry, left out of the block above: ENABLED_TOOLGROUPS (Comma-separated list of tool groups to enable (readonly or readwrite)).

Alternatives to Google Calendar

same job, measured the same way
Google Docs
by pulsemcp

MCP server for Google Docs integration with OAuth2 and service account support.

96 installs/wk local only
Google MCP
by matiasbattocchia

Streamable HTTP MCP server for Google Calendar and Sheets with OAuth login.

answering
Google Workspace
by mindstone

Google Workspace MCP server for Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, and more

256 installs/wk local only
MCP Gee Sweet
by khuisman

MCP server for Google Workspace — Sheets, Drive, Docs (HTML or Markdown), Calendar, and Gmail.

15 970 installs/wk local only
Google Docs MCP Server
by gigabrain-observer

Google Docs MCP server with full tab support, markdown extraction, and batch updates.

110 installs/wk local only
Google Sheets MCP Server
by joshuawhite389

Read and write Google Sheets with your own service account: list tabs, read, append, update, export.

answering
Google Ads MCP by InsightfulPipe
by insightfulpipe

Hosted Google Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.

answering
Gws Connector
by orieg

Multi-account Google Workspace MCP — Gmail, Calendar, Drive, Sheets, Docs with smart routing.

local only

Google Calendar — questions

Answers built from our own checks of this server.

Why is there no uptime for Google Calendar?
Google Calendar runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package google-calendar-workspace-mcp-server was installed 144 times last week.
How do I connect Google Calendar?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls google-calendar-workspace-mcp-server straight from npm; nothing to host, nothing to sign up for.
How many people use Google Calendar?
The npm package google-calendar-workspace-mcp-server was installed 144 times in the last week. Week over week that is -34%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Google Calendar open source?
Yes — it is published under the MIT licence, written in TypeScript, 81 stars on GitHub and 27 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.