# Google Calendar MCP

> Google Calendar MCP is an open-source MCP server for productivity. Check schedules, book meetings with Meet links and block focus time in Google Calendar. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/a1-x-tech/mcp-google-calendar
- **MCP Registry name:** io.github.A1-x-Tech/mcp-google-calendar
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

This server lets an AI app manage Google Calendar through the official API with your own account. The README lists 19 tools: inspecting calendars, events and free/busy, creating and editing events, expanding recurring series, blocking Out of Office and Focus Time, and six for connecting your Google account from the chat so no credentials file has to be hand-written.

It is cautious about side effects. The Calendar API's default is not to email guests, and this server sends invitations, changes or cancellations only when you ask through the send_updates option. After an ambiguous failure it does not retry a write, because a duplicate event could email every guest again. It also separates a whole recurring series from a single occurrence, so you can cancel one Friday standup without touching the rest.

Scopes are kept narrow, using calendar.events and calendar.readonly rather than the broad calendar scope. It runs over stdio with Node.js 20 or later and OAuth credentials from a Google Cloud project with the Calendar API enabled.

## Features

- **Schedule review:** Lists events and spots overlapping meetings.
- **Meeting creation:** Schedules events with guests and a Google Meet link.
- **Free slot finding:** Uses free/busy to find a time several people share.
- **Recurring series control:** Edits or cancels one occurrence or the whole series.
- **Out of Office and Focus Time:** Blocks time and can auto-decline invitations.
- **Quiet by default:** Guests are emailed only when send_updates is requested.

## Good for

- Review the week and find overlapping meetings
- Book a 45-minute review with guests and a Meet link
- Find an hour when three people are free
- Cancel a single occurrence of a recurring meeting
- Block focus time tomorrow morning

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-google-calendar --env GOOGLE_CALENDAR_CLIENT_SECRET='<GOOGLE_CALENDAR_CLIENT_SECRET>' --env GOOGLE_CALENDAR_REFRESH_TOKEN='<GOOGLE_CALENDAR_REFRESH_TOKEN>' --env GOOGLE_CALENDAR_ACCESS_TOKEN='<GOOGLE_CALENDAR_ACCESS_TOKEN>' -- npx -y @a1-x-tech/mcp-google-calendar
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@a1-x-tech/mcp-google-calendar"
      ],
      "env": {
        "GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
        "GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
        "GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@a1-x-tech/mcp-google-calendar"
      ],
      "env": {
        "GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
        "GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
        "GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-google-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@a1-x-tech/mcp-google-calendar"
      ],
      "env": {
        "GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
        "GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
        "GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@a1-x-tech/mcp-google-calendar"
      ],
      "env": {
        "GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
        "GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
        "GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@a1-x-tech/mcp-google-calendar"
      ],
      "env": {
        "GOOGLE_CALENDAR_CLIENT_SECRET": "<GOOGLE_CALENDAR_CLIENT_SECRET>",
        "GOOGLE_CALENDAR_REFRESH_TOKEN": "<GOOGLE_CALENDAR_REFRESH_TOKEN>",
        "GOOGLE_CALENDAR_ACCESS_TOKEN": "<GOOGLE_CALENDAR_ACCESS_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Will guests get emails automatically?

No. The README says guests get email only when you ask via send_updates.

### What happens after a failed write?

The server does not replay writes after an ambiguous failure, to avoid duplicate events.

### Which Google scopes does it use?

calendar.events and calendar.readonly, not the broad calendar scope.

### Can I sign in from the chat?

Yes, six of the tools handle connecting your Google account without a credentials file.

### What does it need?

Node.js 20 or later and OAuth credentials with the Calendar API enabled.

### 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 mcp-google-calendar --env GOOGLE_CALENDAR_CLIENT_SECRET='<GOOGLE_CALENDAR_CLIENT_SECRET>' --env GOOGLE_CALENDAR_REFRESH_TOKEN='<GOOGLE_CALENDAR_REFRESH_TOKEN>' --env GOOGLE_CALENDAR_ACCESS_TOKEN='<GOOGLE_CALENDAR_ACCESS_TOKEN>' -- npx -y @a1-x-tech/mcp-google-calendar

### What are the best alternatives to Google Calendar MCP?

The closest alternatives to Google Calendar MCP are Ha MCP, Concord MCP, note1, InviteKit Calendar Files and Google Workspace MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp-2): Google Workspace MCP is an MCP server for productivity.
- [Google_calendar](https://ai-powered.com/mcp/google-calendar-3): Google_calendar is a freemium MCP server for productivity.
- [Zovo Org Chart Maker](https://ai-powered.com/mcp/zovo-org-chart-maker): Zovo Org Chart Maker is an MCP server for productivity.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/google-calendar-mcp-2
