home / mcp / calendar mcp server

Calendar MCP Server

Provides MCP-enabled Google Calendar management for Claude Desktop to create, list, update, and delete events.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "smithery-ai-calendar-mcp-server": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-calendar-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id_here",
        "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
      }
    }
  }
}

You can run a Calendar MCP Server that lets Claude Desktop talk to Google Calendar to create, retrieve, update, delete, and list events through natural language interactions. It securely authenticates with Google and exposes a straightforward way to manage calendar data from your AI assistant.

How to use

You will connect the Calendar MCP Server to Claude Desktop using your Google API credentials. Once running, you can ask your assistant to create events, fetch event details by ID, modify event details like title or time, delete events, or list events within a time range. The server handles Google Calendar authentication and forwards your requests to the Calendar API, returning results back to Claude Desktop for natural language responses.

How to install

Prerequisites: ensure you have Node.js installed on your machine. You may also install via a package manager, or run the server directly with a node-based command.

Step 1: Install the MCP package for Calendar integration locally.

npm install @gongrzhe/server-calendar-mcp

Additional setup and configuration

Prepare Google Cloud credentials to allow secure access to Google Calendar. You will need a Google Client ID, Google Client Secret, and a Refresh Token. These credentials must be kept secure in your Claude Desktop configuration.

{
  "calendar": {
    "command": "npx",
    "args": [
      "@gongrzhe/server-calendar-mcp"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id_here",
      "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
    }
  }
}

Security notes

Keep your Google API credentials secure and rotate refresh tokens regularly. Store sensitive information only in Claude Desktop configuration and never share credentials in version control.

Usage tips

When you start the server, it will listen for commands from Claude Desktop. Use natural language prompts to perform calendar operations, and rely on the server to translate those prompts into Google Calendar API requests.

Available tools

Create Event

Create a new Google Calendar event by specifying a title, start and end times, description, and location.

List Events

List events within a specified time range, with options to limit results and order by start time.

Get Event

Retrieve details of a specific event using its event ID.

Update Event

Update existing event fields such as title, time, description, or location.

Delete Event

Delete an event by its ID.

OAuth2 Authentication

Securely authenticate with Google Calendar using OAuth 2.0 to obtain access via a refresh token.