README

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

Go to Google Cloud Console
Create a new project (or select existing)
Enable the Google Calendar API
Create OAuth 2.0 credentials (Desktop app)
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

Tool	Description
`list_events`	List upcoming events (default: next 7 days)
`create_event`	Create a new calendar event
`find_free_slots`	Find available time slots
`update_event`	Update an existing event
`delete_event`	Delete/cancel an event

License

MIT

Google Calendar MCP Server

README

Google Calendar MCP Server

Features

Installation

Google Cloud Setup

Usage

Running the server

Connecting to Claude Desktop

Tools

License

Recommended Servers