MCP.so
Sign In

Google Calendar MCP Server

@Jackson88

About Google Calendar MCP Server

Model Context Protocol (MCP) server for Claude Desktop connecting to Google Calender using Google Calendar API

Basic information

Category

Productivity

License

View license

Runtime

node

Transports

stdio

Publisher

Jackson88

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<your-client-id>",
        "GOOGLE_CLIENT_SECRET": "<your-client-secret>",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/auth/callback"
      },
      "description": "Google Calendar MCP server using npx"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Calendar MCP Server?

A TypeScript-based Model Context Protocol (MCP) server that allows Claude Desktop to connect to and interact with Google Calendar.

How to use Google Calendar MCP Server?

Clone the repository, install dependencies, configure the .env file with the chosen authentication method (Google Cloud OAuth or direct), then run the server in development or production mode. Authenticate with Google via the provided endpoints, and configure Claude Desktop’s settings to connect to the server via MCP.

Key features of Google Calendar MCP Server

  • Connect Claude Desktop AI to Google Calendar data
  • Authenticate via Google OAuth2 or direct authentication
  • List calendars and retrieve events
  • Create, update, and delete calendar events
  • Get upcoming events across all calendars
  • Secure local token storage

Use cases of Google Calendar MCP Server

  • Ask Claude for today’s or this week’s events
  • Schedule a meeting, appointment, or recurring event
  • Check for scheduling conflicts in a time window
  • Reschedule or cancel existing events
  • Find free time slots for a meeting

FAQ from Google Calendar MCP Server

What authentication methods are supported?

Two methods: Google Cloud OAuth (recommended, requires a Google Cloud project) and direct authentication (simpler, no Google Cloud setup, but subject to Google’s security policies).

What are the runtime requirements?

Node.js v16 or higher, npm or yarn, a Google account with Calendar access, and OAuth 2.0 credentials if using the Google Cloud method.

Can Claude Desktop currently connect to this MCP server?

As of April 2025, Claude Desktop may have limited or no support for external MCP connections. Testing indicates the current version does not connect to this server. The server itself functions independently for direct API use.

How are authentication tokens stored?

Tokens are saved locally in files. They should be kept secure and never committed to version control.

Can I deploy with Docker?

Yes. The project includes a Docker Compose configuration for containerized deployment.

What is the difference between the two auth methods?

Google Cloud OAuth follows standard OAuth 2.0 and is more secure and reliable for production. Direct authentication is simpler for personal/development use but may stop working if Google changes its authentication requirements.

Comments

More Productivity MCP servers