Google Calendar MCP Server

This MCP server provides access to your Google Calendar events and allows you to manage them through an MCP interface. It can be used with Claude Desktop or any other MCP-compatible client.

Requirements

• Python 3.10 or higher - MCP requires Python 3.10+
• Google Cloud project with Calendar API enabled
• OAuth credentials for authentication

Features

• View calendar events for any date or date range
• Create new events with title, time, description, location, and attendees
• Update existing events with new details
• Pre-built prompts for common calendar actions

Installation

1. Clone this repository:

   git clone 
   cd google-calendar-mcp
   

2. Create a virtual environment with Python 3.10 or higher:

   # Check your Python version
   python --version
   
   # Create a virtual environment with the correct Python version
   # For Python 3.10
   python3.10 -m venv venv
   # OR for Python 3.11
   python3.11 -m venv venv
   # OR for Python 3.12
   python3.12 -m venv venv
   
   # Activate the virtual environment
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies using pip:

   pip install -r requirements.txt
   

   Alternatively, you can use uv for faster installation (recommended):

   # Install uv if you don't have it
   curl -fsSL https://astral.sh/uv/install.sh | sh
   # On Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
   
   # Install dependencies with uv
   uv pip install -r requirements.txt
   

4. Set up Google Calendar API credentials:

   a. Go to the Google Cloud Console b. Create a new project or select an existing one c. Enable the Google Calendar API d. Create OAuth credentials (Desktop client OAuth ID) e. Download the credentials JSON file and save it as credentials.json in the project directory

Usage

Using with Claude Desktop

1. Install Claude Desktop from the official website

2. Install the MCP server in Claude Desktop:

   # Make sure you're in the project directory with the virtual environment activated
   mcp install calendar_mcp_server.py
   

3. Configure Claude Desktop to use the MCP server by editing the Claude Desktop configuration file:

   • Locate the Claude configuration file at /path/to/your/claude_desktop_config.json (Mac) or appropriate location for your OS
   • Add or modify the configuration to include the Google Calendar MCP:

   {
     "Google Calendar": {
       "command": "/path/to/your/venv/bin/mcp",
       "args": [
         "run",
         "/path/to/your/project/calendar_mcp_server.py"
       ]
     }
   }
   

   • Replace /path/to/your/venv/ with the actual path to your virtual environment
   • Replace /path/to/your/project/ with the actual path to your project directory