← Back to Google Calendar MCP

Install Google Calendar MCP

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know — edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

git clone https://github.com/QuantGeekDev/google-calendar-mcp-app.git
cd google-calendar-mcp-app
npm install
npm run build
2

Register it in Claude Code

claude mcp add -e "GOOGLE_OAUTH_CREDENTIALS=${GOOGLE_OAUTH_CREDENTIALS}" google-calendar-mcp -- node /absolute/path/to/google-calendar-mcp-app/build/index.js

Replace any placeholder paths in the command with the real path on your machine.

Required:GOOGLE_OAUTH_CREDENTIALS

Environment Variables

Set these before running Google Calendar MCP.

VariableDescriptionRequired
GOOGLE_OAUTH_CREDENTIALSPath to the downloaded Google OAuth JSON credentials file.Yes

Available Tools (1)

Once configured, Google Calendar MCP gives your AI agent access to:

calendar_toolsA suite of 13 calendar tools for managing schedules, creating events, and visualizing availability.
event_detailssearch_eventscreate_eventdelete_event

Try It Out

After setup, try these prompts with your AI agent:

What's on my calendar this week?
Am I free Thursday?
Search for meetings related to project planning.
Show me the team meeting details.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • GOOGLE_OAUTH_CREDENTIALS — Path to the downloaded Google OAuth JSON credentials file.

Keep this setup from going cold

Save the docs, env vars, and workflow around Google Calendar MCP in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup