Google_Calendar_MCP

Google_Calendar_MCP

3.3

If you are the rightful owner of Google_Calendar_MCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This repository provides a Model Context Protocol (MCP) server that integrates with the Google Calendar API, allowing users to manage calendar events through Anthropic's Claude Desktop.

Google Calendar MCP Server

This repository provides a Model Context Protocol (MCP) server that integrates with the Google Calendar API. It allows users to list, create, delete, and update calendar events. The server is designed to work with Anthropic's Claude Desktop as an MCP client.

🚀 Features

  • Interact with Google Calendar: list, add, delete, and update events
  • Seamless integration with Claude Desktop via MCP

🧰 Prerequisites


📦 Installation

  1. Install UV Package Manager: Follow the instructions on the official UV installation guide.

  2. Clone the Repository and Set Up Environment:

    git clone https://github.com/rsc1102/Google_Calendar_MCP.git
    cd Google_Calendar_MCP
    uv sync
    
  3. Create Google Cloud Credentials:

    • Visit Google Cloud Console.
    • Create a new project or select an existing one.
    • Enable the Google Calendar API.
    • Navigate to APIs & Services > Credentials.
    • Click Create Credentials > OAuth Client ID:
      • Choose Desktop app as the application type.
      • Download the generated credentials.json file.
      • Place credentials.json inside the Google_Calendar_MCP directory.

🔌 Integration with Claude Desktop

  1. Locate Configuration File: Open the claude_desktop_config.json file on your system:

    Linux/macOS:

    code ~/Library/Application\ Support/Claude/claude_desktop_config.json
    

    Windows (PowerShell):

    code $env:AppData\Claude\claude_desktop_config.json
    
  2. Add MCP Server Configuration: Add the following to the mcpServers section:

    {
        "mcpServers": {
            "calendar": {
                "command": "uv",
                "args": [
                    "--directory",
                    "/ABSOLUTE/PATH/TO/PARENT/FOLDER/Google_Calendar_MCP",
                    "run",
                    "calendar_mcp.py"
                ]
            }
        }
    }
    
  3. Restart Claude Desktop.

  4. Create a New Project in Claude Desktop.

  5. Set Timezone: In the project's knowledge section, define your local timezone using the IANA Time Zone format (e.g., timeZone="America/New_York").

  6. Start Chatting: Begin interacting with Claude to manage your Google Calendar events.
    Note: When using the server for the first time, Google will prompt you to authenticate and grant permission to access your calendar.


🎬 In Action

https://github.com/user-attachments/assets/75da4943-15c4-4ec2-bc5d-af4af3509031


📬 Support

For issues or questions, please open an issue in this repository.