home / mcp / google calendar mcp server

Google Calendar MCP Server

Provides Google Calendar API integration to manage events, recurrences, attendees, and reminders.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "avik-creator-googlecalendarmcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-google-calendar.avikm744.workers.dev/sse"
      ]
    }
  }
}

This Google Calendar Integration MCP Server lets you manage calendar events programmatically through the Google Calendar API. It supports creating, reading, updating, deleting events, handling recurring events, managing attendees, and configuring event notifications, enabling you to automate and integrate calendar workflows into your applications or assistants.

How to use

You connect to the Google Calendar MCP Server through an MCP client. Once connected, you can perform common calendar operations from your client by invoking the server’s exposed actions. The server handles authentication with Google, communicates with the Calendar API, and returns the results you need to drive your application or assistant flows.

How to install

Prerequisites you must have before installing this MCP server include Python 3.8 or higher, a Google Cloud Platform account, enabled Google Calendar API access, and OAuth 2.0 credentials configured.

Option 1: Install automatically via Smithery for Claude Desktop

npx -y smithery install @Avik-creator/googlecalendarMCP --client claude

Option 2: Manual installation

Step 1: Clone the repository

git clone https://github.com/Avik-creator/googlecalendarMCP
cd googlecalendarMCP

Step 2: Set up a virtual environment

python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate

Step 3: Install dependencies

pip install -r requirements.txt

Step 4: Google Cloud Platform setup

a. Go to the Google Cloud Console and select or create a project. b. Enable the Google Calendar API. c. Create OAuth 2.0 credentials as a Desktop Application and download the credentials JSON file. d. Rename it to credentials.json and place it in the project root.

Step 5: Environment variables

GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json
[email protected]

Step 6: Authentication and running the app

# First-time authentication
python auth.py

# Run the application
python main.py

Available tools

Create Event

Add a new calendar event with specified details such as title, time, location, and attendees.

Read Event

Retrieve details of a specific event from the calendar, including attendees and reminders.

Update Event

Modify an existing event’s details, including time, attendees, and recurrence settings.

Delete Event

Remove an event from the calendar.

Recurring Events

Set up and manage recurring events with rules for frequency, end, and exceptions.

Attendees Management

Add, update, or remove attendees from events and track response statuses.

Notifications & Reminders

Configure and manage event notifications and reminders to participants.