How do I install the gcalendar mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `GOOGLE_REFRESH_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

GCalendar MCP Server

MCP server implementation for Google Calendar integration

Local serverstdio

What is the GCalendar MCP Server?

MCP server implementation for Google Calendar integration

What you get

A Model Context Protocol (MCP) server implementation that enables AI assistants like Claude to create and manage Google Calendar events.

Create calendar events with title, description, start/end times, and alert
Support for adding event attendees
OAuth2 authentication with Google Calendar API
Full MCP protocol implementation
Debug logging for troubleshooting

Configuration and credentials

Node.js v18 or later - Google Cloud Console project with Calendar API enabled - OAuth2 credentials (Client ID and Client Secret)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the GCalendar MCP Server

{
  "mcpServers": {
    "zmes-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@tobedoit/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_google_client_id",
        "GOOGLE_CLIENT_SECRET": "YOUR_GOOGLE_CLIENT_SECRET",
        "GOOGLE_REFRESH_TOKEN": "YOUR_GOOGLE_REFRESH_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Node.js v18 or later - Google Cloud Console project with Calendar API enabled - OAuth2 credentials (Client ID and Client Secret)

Variable	Description	Required
GOOGLE_CLIENT_ID	Declared in the maintainer’s client configuration.	Check documentation
GOOGLE_CLIENT_SECRET	Declared in the maintainer’s client configuration.	Check documentation
GOOGLE_REFRESH_TOKEN	Declared in the maintainer’s client configuration.	Check documentation

Frequently asked questions

MCP server implementation for Google Calendar integration Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.