Google_Calendar_MCP

This MCP server integrates Google Calendar with Claude Desktop via the UV runtime. It exposes capabilities to list, add, delete, and update calendar events by interpreting natural language prompts and translating them into Google Calendar API calls through the MCP interface. The server is designed to work with Claude Desktop, allowing you to create or modify events, view upcoming schedules, and manage calendars directly from your Claude projects. After setup, you can start conversations in Claude to perform operations such as listing events, creating new events with a date and time, updating existing entries, or deleting events, with the server handling the underlying API interactions.

Prerequisites:

• Python installed on your system
• UV package manager installed and configured
• Google Cloud credentials (credentials.json) for Google Calendar API access
• Claude Desktop for MCP client (optional but recommended)

Installation steps:

1. Install UV (follow the official guide):

# example: install via UV website instructions

2. Clone the repository and set up the project structure:

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

3. Prepare Google Cloud credentials:

- Create a project and enable Google Calendar API
- Create OAuth Client ID (Desktop app)
- Download credentials.json and place it in the project root (Google_Calendar_MCP)

4. Ensure you have the Python script calendar_mcp.py ready (as provided by the repo).
5. Run the MCP server via UV using the configuration below (see mcp_config):

uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/Google_Calendar_MCP run calendar_mcp.py

6. In Claude Desktop, add the MCP server under mcpServers using the provided configuration and restart Claude to pick up the new server.

Tips and notes:

• The first authentication with Google will prompt in a browser to grant calendar access; ensure the credentials.json file is correctly placed.
• Use absolute paths in the UV directory argument to avoid path resolution issues.
• If you update calendar_mcp.py, restart Claude Desktop or reinitialize the MCP server in Claude to pick up changes.
• Ensure the timezone is set in Claude project settings for accurate event times.
• Common issues include OAuth consent screen limits, API quota limits, and missing/invalid credentials.json; verify the Google Cloud project has the Calendar API enabled and OAuth client is desktop-type.