MCP ExplorerExplorer

Google Calendar Mcp

@rsc1102on a year ago
4 MIT
FreeCommunity
AI Systems
#anthropic#anthropic-claude#claude#google-calendar-api#model-context-protocol#model-context-protocol-servers
Model Context Protocol (MCP) server that integrates with the Google Calendar API

Overview

What is Google Calendar Mcp

Google_Calendar_MCP is a Model Context Protocol (MCP) server that integrates with the Google Calendar API, allowing users to manage calendar events seamlessly.

Use cases

Use cases include scheduling meetings, managing personal appointments, and integrating calendar functionalities into applications that require event handling.

How to use

To use Google_Calendar_MCP, install the UV Package Manager, clone the repository, set up your environment, create Google Cloud credentials, and configure the MCP server with Claude Desktop.

Key features

Key features include the ability to list, create, delete, and update calendar events, along with seamless integration with Claude Desktop via MCP.

Where to use

Google_Calendar_MCP can be used in personal productivity, team collaboration, and any application that requires calendar event management.

Content

Google Calendar MCP Server Anthropic Claude

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.

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers