Google Calendar MCP

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:

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

Mac/Linux:

~/.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:

claude 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:

claude 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:

{
  "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

# 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