Google Calendar MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to manage Google Calendar.

Features

• 📅 List events — View upcoming calendar events

• ➕ Create events — Schedule new meetings and appointments

• 🔍 Find free slots — Check availability for scheduling

• ✏️ Update events — Reschedule or modify existing events

• 🗑️ Delete events — Cancel events

Installation

# Clone the repo
git clone https://github.com/SamRind/gcal-mcp-server.git
cd gcal-mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Google Cloud Setup

1. Go to Google Cloud Console

2. Create a new project (or select existing)

3. Enable the Google Calendar API

4. Create OAuth 2.0 credentials (Desktop app)

5. Download the credentials JSON and save as credentials.json in the project root

Usage

Running the server

python server.py

Connecting to Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gcal": {
      "command": "python",
      "args": ["/path/to/gcal-mcp-server/server.py"]
    }
  }
}

Tools

License

MIT