Gcalendar MCP Python

🚀 MCP Calendar

The MCP (Model Context Protocol) Server is a tool for creating events via Google Calendar.

🚀 Quick Start

The MCP (Model Context Protocol) Server serves as a tool for creating events through Google Calendar.

📦 Installation

pip install mcp-calendar-python

✨ Features

• Create Google Calendar events from the Claude desktop application via the MCP server.
• Securely authenticate with the Google Calendar API using OAuth2.
• Support event creation, modification, and viewing.

📚 Documentation

Prerequisites

• Python 3.10 or higher.
• OAuth 2.0 client ID and secret generated in the Google Cloud Console.
• Claude desktop application.

Setup Steps

1. Create a project and generate an OAuth 2.0 client ID in the Google Cloud Console:

   • Open the Google Cloud Console and create a new project.
   • Navigate to APIs & Services > Credentials and create an OAuth 2.0 client ID.
   • Enable the Calendar API.

2. Set environment variables:

GOOGLE_CLIENT_ID="your_client_id"
GOOGLE_CLIENT_SECRET="your_client_secret"
GOOGLE_REFRESH_TOKEN="your_refresh_token"

3. Use the following configuration in the Claude desktop application:

{
  "mcp-calendar-python": {
    "command": "uvx",
    "args": [
      "mcp-calendar-python"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id", 
      "GOOGLE_CLIENT_SECRET": "your_client_secret", 
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
    }
  }
}

Usage

You can send the following requests to Claude:

• "Schedule a team meeting at 2 PM tomorrow."
• "Schedule a meeting at noon on May 15th."

📄 License

This project is released under the MIT License.