Gcal MCP Server

🚀 Google Calendar MCP Server

This is a Model Context Protocol (MCP) server that integrates with Google Calendar through standardized interfaces, allowing LLM applications to manage calendar events.

🚀 Quick Start

The Google Calendar MCP Server is a powerful tool that enables seamless integration with Google Calendar via standardized interfaces. It empowers LLM applications to efficiently manage calendar events.

✨ Features

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

📦 Installation

Steps

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 the package in editable mode
uv pip install -e .

💻 Usage Examples

Basic Usage

1. Set the required environment variables in the .env file.
2. Run the server:

uv run client.py

📚 Documentation

Google Cloud Setup

1. Visit the Google Cloud Console.
2. Create a new project or select an existing one.
3. Enable the Google Calendar API.
4. Create OAuth 2.0 credentials:
   • Navigate to Credentials.
   • Click "Create credentials" > "OAuth client ID".
   • Select "User data" as the type of data your application will access.
   • Add your application name and contact information.
   • Add the following scopes (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.
     • Note: It may take a few minutes for the test user to propagate.