what is Google Calendar MCP Server?
Google Calendar MCP Server is a Model Context Protocol (MCP) server that provides access to Google Calendar data, allowing users to interact with their calendars programmatically.
how to use Google Calendar MCP Server?
To use the server, set up your Google Cloud project with Calendar API enabled, install the required dependencies, configure your OAuth2 credentials, and run the server using Python.
key features of Google Calendar MCP Server?
- List available Google Calendars
- Find available time slots in a calendar
- Get upcoming events from a calendar
use cases of Google Calendar MCP Server?
- Integrating Google Calendar functionalities into applications.
- Automating scheduling tasks based on calendar availability.
- Fetching and displaying upcoming events in custom interfaces.
FAQ from Google Calendar MCP Server?
- What are the prerequisites to run the server?
You need Python 3.9+, a Google Cloud project with Calendar API enabled, and OAuth2 credentials.
- How do I install the server dependencies?
Use the command
pip install -r requirements.txtto install the necessary packages.
- Can I customize the time slot duration?
Yes, you can specify the
slot_duration_minutesparameter when finding available slots.
Google Calendar MCP Server
A Model Context Protocol (MCP) server that provides access to Google Calendar data.
Features
- List available Google Calendars
- Find available time slots in a calendar
- Get upcoming events from a calendar
Prerequisites
- Python 3.9+
- Google Cloud project with Calendar API enabled
- OAuth2 credentials
Setup
-
Install dependencies:
pip install -r requirements.txt -
Set up Google Calendar API credentials:
python setup_credentials.pyFollow the prompts to authenticate with Google.
-
Run the server:
python google_calendar_server.py
Using with Claude Desktop
Configure Claude Desktop to use this server by editing the configuration file:
{
"mcpServers": {
"google-calendar": {
"command": "python",
"args": ["/full/path/to/google_calendar_server.py"],
"env": {
"GOOGLE_TOKEN_FILE": "/path/to/token/file.json"
}
}
}
}
Available Tools
list_calendars
Lists all available Google Calendars.
get_available_slots
Finds available time slots in a calendar.
Parameters:
calendar_id: The ID of the calendar to checkdays_ahead: Number of days ahead to check (default: 7)slot_duration_minutes: Duration of each slot in minutes (default: 30)start_hour: Start hour of the day in 24-hour format (default: 9)end_hour: End hour of the day in 24-hour format (default: 17)
get_upcoming_events
Gets upcoming events from a calendar.
Parameters:
calendar_id: The ID of the calendar to checkdays_ahead: Number of days ahead to check (default: 7)max_events: Maximum number of events to return (default: 10)
