notes

Google Calendar MCP Server

Feb 17, 2026 → Mar 22, 20262 min read

Google Calendar MCP Server

MCP server for Google Calendar integration. Allows reading and creating calendar events.

Status

  • Location: /home/ubuntu/claude-workspace/mcp-servers/calendar-mcp/
  • Binary: calendar-mcp
  • Status: ✅ Working (2026-02-17)

Tools

list_events

Get events for the next N days.

Parameters:

  • days (int, optional): Number of days ahead. Default: 7

list_events_range

Get events between two dates.

Parameters:

  • start_date (string, required): Start date, format YYYY-MM-DD
  • end_date (string, required): End date, format YYYY-MM-DD

create_event

Create a new event.

Parameters:

  • summary (string, required): Event title
  • date (string, required): Date, format YYYY-MM-DD
  • start_time (string, required): Start time, format HH:MM (24-hour)
  • end_time (string, required): End time, format HH:MM
  • description (string, optional): Description

edit_event

Edit an existing event.

Parameters:

  • event_id (string, required): Event ID (from list_events)
  • summary (string, optional): New title
  • description (string, optional): New description
  • date (string, optional): New date, format YYYY-MM-DD
  • start_time (string, optional): New start time, format HH:MM
  • end_time (string, optional): New end time, format HH:MM

Configuration

Environment Variables

  • GOOGLE_CREDENTIALS_FILE: Path to service account JSON key
  • CALENDAR_ID: Calendar ID (usually email)

Claude Code

In ~/.claude.json:

{
  "mcpServers": {
    "google-calendar": {
      "type": "stdio",
      "command": "/home/ubuntu/claude-workspace/mcp-servers/calendar-mcp/calendar-mcp",
      "env": {
        "GOOGLE_CREDENTIALS_FILE": "/home/ubuntu/.takopi/credentials/google-calendar-service-account.json",
        "CALENDAR_ID": "ccherya@gmail.com"
      }
    }
  }
}

Building

cd /home/ubuntu/claude-workspace/mcp-servers/calendar-mcp
go build -o calendar-mcp .

Graph View

Backlinks