Skip to main content
Glama

Google Calendar MCP Server

An MCP server that provides tools to query Google Calendar events.

Setup

1. Create Google Cloud credentials

  1. Go to Google Cloud Console

  2. Create a new project or select an existing one

  3. Enable the Google Calendar API

  4. Go to APIs & Services > Credentials

  5. Click Create Credentials > OAuth client ID

  6. Select Desktop app as the application type

  7. Download the JSON file and save it as credentials.json in this directory

2. Install dependencies

uv sync

3. Authenticate (first run)

On the first run, a browser window will open for Google OAuth authentication:

uv run python server.py

This creates a token.json file for future use.

Tools

Tool

Description

get_upcoming_events

Get the next N upcoming events

get_events_for_date

Get events for a specific date (YYYY-MM-DD)

search_events

Search events by keyword

list_calendars

List all available calendars

Usage with Amp/Claude

Add to your MCP configuration:

{ "mcpServers": { "gcal": { "command": "uv", "args": ["run", "--directory", "/path/to/gcal-mcp", "python", "server.py"] } } }

Example queries

  • "What meetings do I have today?"

  • "Show me my next 5 calendar events"

  • "Do I have any events with 'standup' in the title?"

  • "What's on my calendar for 2025-01-15?"

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/alDuncanson/gcal-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server