概要
What is Google Calendar MCP Server?
A Model Context Protocol (MCP) server that provides programmatic access to Google Calendar data. It integrates with any MCP-compatible client (e.g., Claude Desktop) to allow listing calendars, checking available time slots, and retrieving upcoming events. Designed for developers and power users who need to interact with Google Calendar through AI assistants or automated workflows.
How to use Google Calendar MCP Server?
Install the Python dependencies with pip install -r requirements.txt, then run python setup_credentials.py to authenticate with Google. Start the server with python google_calendar_server.py. For use with Claude Desktop, configure the MCP server entry with the full path to the script and set the GOOGLE_TOKEN_FILE environment variable.
Key features of Google Calendar MCP Server
- List all available Google Calendars.
- Find available time slots in a calendar.
- Get upcoming events from a calendar.
- Configurable search horizon and slot duration.
- OAuth2-based authentication with Google Calendar API.
- Works with any MCP-compatible client.
Use cases of Google Calendar MCP Server
- An AI assistant queries a user’s available meeting slots to schedule a new event.
- A bot retrieves upcoming events to summarize the day’s schedule.
- A workflow checks multiple calendars for overlapping availability.
- A developer builds a custom tool to automate calendar management.
FAQ from Google Calendar MCP Server
What tools does the server expose?
It exposes three tools: list_calendars (list all calendars), get_available_slots (find free time slots with configurable duration and hour range), and get_upcoming_events (fetch upcoming events with a max count).
What are the prerequisites?
Python 3.9 or later, a Google Cloud project with the Calendar API enabled, and OAuth2 credentials (client ID and secret).
How do I set up authentication?
Run python setup_credentials.py and follow the prompts to authenticate with Google. The resulting token is stored in a file specified by the GOOGLE_TOKEN_FILE environment variable.
How do I configure it with Claude Desktop?
Edit Claude Desktop’s configuration JSON: set the command to python, the args to the full path of google_calendar_server.py, and provide the GOOGLE_TOKEN_FILE environment variable pointing to your token file.
Where does authentication data live?
The OAuth2 token is stored locally in the file path given by the GOOGLE_TOKEN_FILE environment variable. No external data storage is used.
