---

name: google-calendar-mcp description: Step-by-step guide for setting up Google Calendar MCP server in Claude Code CLI. Use when users want to (1) connect Google Calendar to Claude Code, (2) set up the @cocal/google-calendar-mcp server, (3) configure OAuth credentials for Google Calendar API, or (4) troubleshoot Google Calendar MCP connection issues.

Google Calendar MCP Setup Guide

Set up Google Calendar integration for Claude Code CLI using the @cocal/google-calendar-mcp server.

Source: https://github.com/nspady/google-calendar-mcp

Prerequisites

• Node.js installed (for npx)
• Google account
• Claude Code CLI installed

Part 1: Google Cloud Console Setup

Step 1: Create Project

1. Go to https://console.cloud.google.com/
2. Click project dropdown (top-left) → New Project
3. Name: Claude Calendar → Create
4. Select the new project from dropdown

Step 2: Enable Calendar API

1. Go to APIs & Services → Library
2. Search "Google Calendar API" → Click → Enable

Step 3: OAuth Consent Screen

1. Go to APIs & Services → OAuth consent screen
2. Select External → Create
3. Fill required fields:
   • App name: Claude Calendar
   • User support email: (your email)
   • Developer contact: (your email)
4. Click Save and Continue
5. Scopes page → Add or Remove Scopes
   • Add: https://www.googleapis.com/auth/calendar
   • Click Update → Save and Continue
6. Test Users → Add Users → Add your Gmail → Save and Continue

Step 4: Create Credentials

1. Go to APIs & Services → Credentials
2. Click + Create Credentials → OAuth client ID
3. Application type: Desktop app
4. Name: Claude Code
5. Click Create → Download JSON

Part 2: Save Credentials

Save the downloaded JSON file:

Windows:

CopyC:\Users\salmanferoz\.google-calendar-mcp\gcp-oauth.keys.json

Mac/Linux:

Copy~/.google-calendar-mcp/gcp-oauth.keys.json

Create the .google-calendar-mcp folder if it doesn't exist.

Part 3: Add MCP to Claude Code

Auto-Setup Command

When the user has saved their credentials, run this command automatically:

Windows:

Copyclaude mcp add --scope user --transport stdio google-calendar --env GOOGLE_OAUTH_CREDENTIALS="C:\Users\salmanferoz\.google-calendar-mcp\gcp-oauth.keys.json" -- npx -y @cocal/google-calendar-mcp

Mac/Linux:

Copyclaude mcp add --scope user --transport stdio google-calendar --env GOOGLE_OAUTH_CREDENTIALS="$HOME/.google-calendar-mcp/gcp-oauth.keys.json" -- npx -y @cocal/google-calendar-mcp

Manual JSON Config (Alternative)

Add to ~/.claude.json:

Copy{
  "mcpServers": {
    "google-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/.google-calendar-mcp/gcp-oauth.keys.json"
      }
    }
  }
}

Part 4: First Authorization

1. Restart Claude Code: claude
2. Ask: "What's on my calendar today?"
3. Browser opens → Sign in with Google
4. Click Continue (ignore "unverified app" warning)
5. Grant calendar permissions
6. Token saved automatically to .google-calendar-mcp/token.json

Available Tools

Features

Environment Variables

MCP Management Commands

Copy# List configured servers
claude mcp list

# Check status (inside Claude Code)
/mcp

# Remove server
claude mcp remove google-calendar

# Get server details
claude mcp get google-calendar

Troubleshooting

File Locations Summary