Google Calendar MCP Server

Productivitystdiov1.4.0

MCP server for Google Calendar that lets AI agents view, create, update, and delete events, check availability across calendars, and schedule meetings via the Calendar API with OAuth. Useful for natural-language scheduling and calendar management.

google-calendar calendar scheduling events productivity meetings

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@cocal/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "<YOUR_GOOGLE_OAUTH_CREDENTIALS>"
      }
    }
  }
}

Tools (3)

list_events

List events within a time range for a calendar.

{
  "type": "object",
  "required": [
    "time_min",
    "time_max"
  ],
  "properties": {
    "time_max": {
      "type": "string",
      "description": "End of range in ISO 8601 format"
    },
    "time_min": {
      "type": "string",
      "description": "Start of range in ISO 8601 format"
    },
    "calendar_id": {
      "type": "string",
      "description": "Calendar ID (defaults to primary)"
    }
  }
}

create_event

Create a calendar event.

{
  "type": "object",
  "required": [
    "summary",
    "start",
    "end"
  ],
  "properties": {
    "end": {
      "type": "string",
      "description": "End time in ISO 8601 format"
    },
    "start": {
      "type": "string",
      "description": "Start time in ISO 8601 format"
    },
    "summary": {
      "type": "string",
      "description": "Event title"
    },
    "attendees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attendee email addresses"
    }
  }
}

check_availability

Find free/busy windows across one or more calendars.

{
  "type": "object",
  "required": [
    "time_min",
    "time_max"
  ],
  "properties": {
    "time_max": {
      "type": "string",
      "description": "End of range in ISO 8601 format"
    },
    "time_min": {
      "type": "string",
      "description": "Start of range in ISO 8601 format"
    },
    "calendar_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Calendars to check"
    }
  }
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server Information

Author: nspady (@nspady)
Repository: https://github.com/nspady/google-calendar-mcp
License: MIT
Version: 1.4.0
Stars: 1,300
Last Updated: June 24, 2026