gcal-mcp-server

gcal-mcp-server

3.2

Google Calendar MCP Server provides integration with Google Calendar, allowing LLM applications to manage calendar events through a standardized interface.

Google Calendar MCP Server

This is a Model Context Protocol (MCP) server that provides integration with Google Calendar. It allows LLMs application manage calendar events through a standardized interface.

Features

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

Google Cloud Setup

  1. Go to 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:
    • 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.
      • Note: It may take a few minutes for the test user to propagate.

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

Usage

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