# Google Calendar MCP

> Google Calendar MCP is an open-source MCP server for productivity. List, read, create and move Google Calendar events from your coding agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** vscode, CLI
- **Website:** https://renzojohnson.com/contributions/google-calendar-mcp
- **MCP Registry name:** com.renzojohnson/google-calendar-mcp
- **Categories:** productivity
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

## Tools

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

## 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

- [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.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

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