Py MCP Gcalendar

🚀 Google Calendar MCP Server - Python Installation Guide

This is a Model Context Protocol (MCP) server that provides access to the Google Calendar API and supports asynchronous operations. The implementation enables efficient calendar management through a standardized interface.

🚀 Quick Start

This server offers a standardized interface to efficiently manage Google Calendar events. It supports asynchronous operations and comes with a comprehensive set of tools for event management and system logging.

✨ Features

API Tools

• List: Query calendar events (from the past two years to one year in the 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):
  • Operational records (with timestamps).
  • Error tracking and debugging.
  • Performance metric collection.

📦 Installation

Prerequisites

# Install the required Python packages
pip install -r requirements.txt

Dependencies:

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

# Clone the repository
git clone https://github.com/yourusername/GCalendar.git
cd GCalendar

# Create the required directories
mkdir -p credentials logs

Authentication Setup

1. Create a project in the Google Cloud Console.
2. Enable the Google Calendar API.
3. Download credentials.json to the credentials/ directory.
4. Run create_token.py:

python src/create_token.py

🔧 Technical Details

Server Configuration

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "gcalendar": {
      "command": "YOUR_CONDA_PATH/envs/mcp-gcalendar/bin/python",
      "args": [
        "YOUR_PATH/GCalendar/src/mcp_server.py"
      ]
    }
  }
}

Path Configuration

Replace the placeholders:

• YOUR_CONDA_PATH options:
  • M1/M2 Mac: /opt/homebrew/Caskroom/miniforge/base
  • Miniconda: ~/miniconda3 or /opt/miniconda3
• YOUR_PATH: The full path where the repository is cloned.

Error Handling

• Automatic token refresh (upon expiration).
• 60-second operation timeout.
• Comprehensive error logging.
• Automatic retry for transient errors.

Project Structure

GCalendar/
├── credentials/
│   ├── credentials.json   # File from Google Cloud Console
│   └── token.json        # File 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 tool
│   ├── mcp_client.py        # MCP client implementation
│   ├── mcp_server.py        # Main server implementation
│   └── renew_token.py       # Token renewal tool
├── requirements.txt
└── README.md

System Requirements

• Python 3.9 or higher.
• Google Calendar API enabled.
• Valid OAuth 2.0 credentials.
• Internet connection.
• Timezone set to Asia/Bangkok.

📄 License

This project is licensed under the MIT License. For more details, see the LICENSE file.