Barie Google Calendar MCP Server

A Model Context Protocol (MCP) server for managing Google Calendar — create, update, delete, search events, check availability, and more.

Installation

# Using uvx (recommended)
uvx --from . barie-google-calendar-mcp

# Or install locally
pip install -e .

Usage

barie-google-calendar-mcp \
  --access-token "YOUR_ACCESS_TOKEN" \
  --refresh-token "YOUR_REFRESH_TOKEN" \
  --client-id "YOUR_CLIENT_ID" \
  --client-secret "YOUR_CLIENT_SECRET" \
  --expiry "2024-12-31T23:59:59Z" \
  --scopes '["https://www.googleapis.com/auth/calendar.events"]'

Required Arguments

• --access-token — Google OAuth2 access token
• --refresh-token — Google OAuth2 refresh token
• --client-id — Google OAuth2 client ID
• --client-secret — Google OAuth2 client secret

Optional Arguments

• --expiry — Token expiry timestamp (ISO format)
• --scopes — OAuth2 scopes as JSON array string (default: calendar.events)

Features

• Create Events — Create calendar events with attendees, reminders, recurrence, Google Meet links, and attachments
• Update Events — Modify any event field (title, time, attendees, location, etc.)
• Delete Events — Remove events with attendee notification options
• List Events — Retrieve events with time range filtering
• Search Events — Full-text search across event titles, descriptions, and locations
• Check Availability — Query free/busy status for one or more calendars
• List Calendars — View all calendars the user has access to
• Timezone Info — Auto-detect user timezone from Google Calendar settings
• Current Date — Get current date/time in the user's timezone

Tools

Development

python server.py --help