Google Calendar MCP

🚀 Google Calendar MCP Server

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

🚀 Quick Start

This server enables seamless interaction with Google Calendar and integrates smoothly with Claude desktop. You can effortlessly manage your calendar events through Claude.

✨ Features

• Interact with Google Calendar: List, add, delete, and update events.
• Seamlessly integrate with Claude desktop.

🧰 Prerequisites

• A Google account.
• Anthropic Claude desktop version.

📦 Installation

1. Install the UV package manager: Follow the instructions in the official UV installation guide.

2. Clone the repository and set up the environment:

   git clone https://github.com/rsc1102/Google_Calendar_MCP.git
   cd Google_Calendar_MCP
   uv sync
   

3. Create Google Cloud credentials:

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

💻 Usage Examples

Integrate with Claude Desktop

1. Locate the 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 the MCP server configuration: Add the following content 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 the time zone: In the knowledge section of the project, define your local time zone using the IANA time zone format (e.g., timeZone="America/New_York").

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

🎬 Demonstration

Video link

📬 Support

If you need help or have questions, please open an issue in this repository.