Skip to content
appsgit

Google Calendar

Google Calendar is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for Google Calendar integration with service account support and domain-wide delegation. It has 81 GitHub stars, is released under the MIT license and runs locally with npx -y google-calendar-workspace-mcp-server.

github.com/pulsemcp/mcp-servers (opens in a new tab)

Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error

View on GitHub (opens in a new tab)

Install Google Calendar

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "your-value",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "your-value",
        "GCAL_IMPERSONATE_EMAIL": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL=your-value --env GCAL_SERVICE_ACCOUNT_PRIVATE_KEY=your-value --env GCAL_IMPERSONATE_EMAIL=your-value --transport stdio google-calendar -- npx -y google-calendar-workspace-mcp-server

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "google-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "your-value",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "your-value",
        "GCAL_IMPERSONATE_EMAIL": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "gcal_service_account_private_key",
      "description": "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY",
      "password": true
    }
  ],
  "servers": {
    "google-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-workspace-mcp-server"
      ],
      "env": {
        "GCAL_SERVICE_ACCOUNT_CLIENT_EMAIL": "your-value",
        "GCAL_SERVICE_ACCOUNT_PRIVATE_KEY": "${input:gcal_service_account_private_key}",
        "GCAL_IMPERSONATE_EMAIL": "your-value"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
GCAL_SERVICE_ACCOUNT_CLIENT_EMAILYesService account email address from Google Cloud Console.
GCAL_SERVICE_ACCOUNT_PRIVATE_KEYsecretYesService account private key in PEM format from Google Cloud Console.
GCAL_IMPERSONATE_EMAILYesEmail address of the user whose calendar to access via domain-wide delegation.
ENABLED_TOOLGROUPSNoComma-separated list of tool groups to enable (readonly or readwrite).

Tools (23)

Parsed from the Tools section of the README; check the repository for the current list.

  • list_calendar_events

    Lists events from a calendar within an optional time range.

  • calendar_id

    Calendar ID (default: "primary")

  • time_min

    Start time in RFC3339 format

  • time_max

    End time in RFC3339 format

  • max_results

    Maximum events to return (default: 10, max: 250)

  • query

    Free text search query

  • single_events

    Expand recurring events (default: true)

  • order_by

    "startTime" or "updated"

  • get_calendar_event

    Retrieves detailed information about a specific event.

  • event_id

    The event ID

  • create_calendar_event

    Creates a new calendar event.

  • summary

    Event title

  • start_datetime

    OR startdate (required): Event start time

  • end_datetime

    OR enddate (required): Event end time

  • location

    Event location

  • attendees

    Array of email addresses

  • update_calendar_event

    Updates an existing calendar event. Uses PATCH semantics - only the fields you provide will be updated; other fields…

  • send_updates

    "all", "externalOnly", or "none" - whether to send update notifications

  • delete_calendar_event

    Deletes a calendar event.

  • list_calendars

    Lists all calendars available to the authenticated user.

  • query_calendar_freebusy

    Queries availability information for calendars.

  • calendar_ids

    Array of calendar IDs to check

  • timezone

    Time zone for the query

About Google Calendar

An MCP (Model Context Protocol) server for Google Calendar integration using service account authentication with domain-wide delegation. This server enables AI assistants to interact with Google Calendar to list events, create events, manage calendars, and query availability.

Similar MCP servers

More productivity MCP servers

All Productivity

FAQ

Google Calendar FAQ

Still curious? Email info@appsgit.com.

How do I install the Google Calendar MCP server?

Add the command npx -y google-calendar-workspace-mcp-server to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Google Calendar free?

The server is open source under the MIT license, so running it is free. It needs credentials (GCAL_SERVICE_ACCOUNT_PRIVATE_KEY) for the service it connects to, which may require a paid account.

Is Google Calendar actively maintained?

The most recent commit was on Aug 30, 2026. The latest release is monorepo-latest-placeholder@0.0.0, published Jul 3, 2025. appsgit only lists MCP servers with a commit in the last six months.