gcal-mcp-server

The Google Calendar MCP Server is designed to facilitate seamless integration with Google Calendar, enabling applications to manage calendar events efficiently. By leveraging the Model Context Protocol (MCP), this server provides a standardized interface for listing, creating, updating, and deleting calendar events. It simplifies the process of interacting with Google Calendar, making it easier for developers to incorporate calendar functionalities into their applications. The server requires setup through the Google Cloud Console, where developers must enable the Google Calendar API and create OAuth 2.0 credentials. Once configured, the server can be installed and run locally, providing a robust solution for calendar management.

Features

• List available calendars
• List events from a calendar
• Create new calendar events
• Update existing events
• Delete events

Usage with Different Platforms

Google Cloud Setup

bash
1. Go to the [Google Cloud Console](https://console.cloud.google.com)
2. Create a new project or select an existing one.
3. Enable the [Google Calendar API](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com).
4. Create OAuth 2.0 credentials:
   - Go to **Credentials**
   - Click **"Create Credentials" > "OAuth client ID"**
   - Choose **"User data"** as the type of data the app will be accessing.
   - Add your app name and contact information.
   - Add the following scope (optional):
     - `https://www.googleapis.com/auth/calendar.events`
   - Select **"Desktop app"** as the application type.
   - Add your email address as a test user under the [OAuth Consent screen](https://console.cloud.google.com/apis/credentials/consent).
     - **Note:** It may take a few minutes for the test user to propagate.

Installation

bash
1. Clone the repository:
   git clone <repository-url>
   cd gcal-mcp-server
2. Create a virtual environment:
   uv venv
   # On Mac / linux
   source .venv/bin/activate
   # On Windows
   .venv\Scripts\activate
   # Install package in editable mode
   uv pip install -e .

Usage

bash
1. Set up the `.env` file with the required environment variables for LLMs.
2. Run the server:
   uv run client.py