home / mcp / google calendar mcp server

Google Calendar MCP Server

Integrates Google Calendar with MCP to view, create, update, and delete events across calendars.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "khryptorgraphics-google-calendar-mcp": {
      "command": "node",
      "args": [
        "C:/Users/ralph/Documents/Cline/MCP/google-calendar-mcp/build/index.js"
      ]
    }
  }
}

This MCP server connects Google Calendar to your MCP workflow, letting you view calendars, list and manage events, and perform create, update, and delete operations from a unified interface.

How to use

You interact with the Google Calendar MCP via an MCP client by sending high-level actions that map to calendar operations. You can list calendars, fetch events from a calendar, create new events, update existing ones, and delete events. Each action translates to a corresponding tool you run through the MCP client, enabling calendar management within your automated tasks or chat-based workflows.

How to install

Prerequisites you need before installing this MCP server are Node.js 16 or higher and a Google Cloud project with the Calendar API enabled along with OAuth 2.0 credentials (Client ID and Client Secret). You also need to place the Google Cloud credentials in the project root.

Step 1: Install dependencies

npm install

Step 2: Build the TypeScript code

npm run build

Step 3: Add the MCP server configuration to your settings

"github.com/pashpashpash/google-calendar-mcp": {
  "command": "node",
  "args": ["C:/Users/ralph/Documents/Cline/MCP/google-calendar-mcp/build/index.js"],
  "env": {},
  "disabled": false,
  "autoApprove": []
}

Troubleshooting and notes

Authentication tokens are created on first use and stored securely for automatic refreshing. Tokens are saved to a file named .gcp-saved-tokens.json. If you encounter authentication issues, ensure the credentials file is correctly named and placed in the project root.

If you see token expiry during testing, re-authenticate as needed. The authentication server may attempt to run on ports 3000–3004; ensure at least one port in that range is free.

Common port conflicts or misconfigured credentials can cause startup failures. Verify the gcp-oauth.keys.json file is properly formatted and located in the project root.

FAQs and capabilities

Available calendar operations include listing calendars, listing events for a calendar, creating events, updating events, and deleting events. Use these capabilities through your MCP client to integrate Google Calendar functionality into your automations.

Available tools

list-calendars

List all available calendars in the connected Google account.

list-events

List events from a specific calendar, with optional filters like time range and maximum results.

create-event

Create a new calendar event with details such as summary, location, description, start/end times, time zone, and attendees.

update-event

Update properties of an existing calendar event identified by its eventId.

delete-event

Remove a calendar event identified by its eventId from a calendar.