[!IMPORTANT]

⚠️ Looking for a Complete Google MCP Solution?

This repository provides Google Calendar integration only. If you need a full-featured Google MCP package — including Gmail, Google Drive, Google Calendar, and more — check out my complete workspace package:

👉 mcp-google-workspace

The mcp-google-workspace package bundles all Google service integrations into a single, easy-to-configure MCP server. It’s the recommended choice for most users.

---

Google Calendar MCP Server

A Model Context Protocol (MCP) server that allows Claude and other MCP clients to interact with Google Calendar. This server enables AI assistants to manage your calendar events, check availability, and handle scheduling tasks.

Features

Calendar Management

• List Events (get-events)

  • View events from any calendar
  • Filter by time range
  • Limit number of results

• List Calendars (list-calendars)

  • View all available calendars
  • Access calendar IDs and settings

• Get Timezone Info (get-timezone-info)

  • Get user’s timezone information

• Get Current Date (get-current-date)

  • Get current date and time in user’s timezone
  • Useful for AI models with outdated knowledge cutoff dates

Event Operations

• Create Events (create-event)

  • Schedule new events with full feature support
  • Add attendees and set reminders
  • Include conference links and attachments
  • Set visibility, transparency, and colors
  • Configure recurring events
  • Automatic timezone detection and conflict checking

• Update Events (update-event)

  • Modify existing events
  • Change time/date with conflict checking
  • Add/remove attendees
  • Update any event details
  • Control notification settings

• Delete Events (delete-event)

  • Remove events from calendar
  • Control notification settings for attendees

Availability Management

• Check Availability (check-availability)
  • Check free/busy status for multiple calendars
  • Time zone awareness
  • Support for checking other users’ availability

Requirements

• Python >= 3.12
• Google Cloud Console Project with Calendar API enabled
• OAuth 2.0 credentials

Installation

1. Set up Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project or select existing one
3. Enable Google Calendar API
4. Create OAuth 2.0 credentials (Desktop Application type)
5. Download credentials and save as credentials.json in the \mcp_server_google_calendar folder

2. Install the Package

# Clone or download the project
cd mcp-google-calendar

# Install the package
pip install -e .

3. Authentication Setup

On first run, the server will automatically open your browser for OAuth authentication. Your credentials will be saved for future use.

Usage

This server can run in two modes: