Google Calendar MCP Server

# Google Calendar MCP Server - Python Installation Guide 📘 **Overview** A Model Context Protocol server that provides access to Google Calendar API with support for asynchronous operations. This implementation enables efficient calendar management through a standardized interface. 🔑 **Key Components** ### API Tools - list: Query calendar events (past 2 years to 1 year future) - create-event: Create new calendar entries - delete-duplicates: Remove duplicate events - delete-event: Delete specific calendar events ### Core Resources - Token Management System (credentials/*.json) - OAuth 2.0 authentication flow - Automatic token refresh handling - Runtime token discovery - Logging System (logs/*.log) - Operation logging with timestamps - Error tracking and debugging - Performance metrics collection 💡 **Implementation Steps** ### Prerequisites ```bash # Install required Python packages pip install -r requirements.txt ``` Dependencies: ```python google-auth-oauthlib==1.0.0 google-auth-httplib2==0.1.0 google-api-python-client==2.108.0 aiohttp==3.8.5 asyncio==3.4.3 ``` ### Initial Setup ```bash # Clone repository git clone https://github.com/yourusername/GCalendar.git cd GCalendar # Create required directories mkdir -p credentials logs ``` ### Authentication Setup 1. Create Google Cloud Console project 2. Enable Google Calendar API 3. Download credentials.json to credentials/ 4. Run create_token.py: ```bash python src/create_token.py ``` ⚙️ **Technical Configuration** ### Server Configuration Add to `claude_desktop_config.json`: ```json { "mcpServers": { "gcalendar": { "command": "YOUR_CONDA_PATH/envs/mcp-gcalendar/bin/python", "args": [ "YOUR_PATH/GCalendar/src/mcp_server.py" ] } } } ``` ### Path Configuration Replace placeholders: • YOUR_CONDA_PATH options: - M1/M2 Mac: `/opt/homebrew/Caskroom/miniforge/base` - Miniconda: `~/miniconda3` or `/opt/miniconda3` • YOUR_PATH: Full repository clone path ### Error Handling - Automatic token refresh on expiry - 60-second operation timeout - Comprehensive error logging - Auto-retry on transient errors ### Project Structure ``` GCalendar/ ├── credentials/ │ ├── credentials.json # From Google Cloud Console │ └── token.json # Generated by create_token.py ├── logs/ │ └── calendar_service.log ├── src/ │ ├── calendar_service.py # Core calendar operations │ ├── create_token.py # Token generation │ ├── list_past_events.py # Event listing utility │ ├── mcp_client.py # MCP client implementation │ ├── mcp_server.py # Main server implementation │ └── renew_token.py # Token renewal utility ├── requirements.txt └── README.md ``` ### System Requirements - Python 3.9 or higher - Google Calendar API enabled - Valid OAuth 2.0 credentials - Internet connectivity - Asia/Bangkok timezone ## License This project is licensed under the MIT License. See LICENSE file for details.