Calendar

Provides a Google Calendar–driven MCP server with OAuth2 authentication to create, read, update, delete, and list events.

javascript

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-gongrzhe_calendar-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@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"
      }
    }
  }
}

The Calendar MCP Server lets your AI assistant manage Google Calendar events through natural language interactions. It supports creating, querying, updating, listing, and deleting events with secure OAuth2 authentication, enabling smooth calendar operations from Claude Desktop or other MCP clients.

How to use

You connect to the Calendar MCP Server from your MCP client (like Claude Desktop) using a standard runtime command. Once connected, you can create events with a title, time, description, and location; retrieve details for a specific event; update fields such as the title, time, or location; delete events; and list upcoming or time-range events.

How to install

Prerequisites you need before installing: Node.js and npm (Node 14+ or newer is recommended). Ensure you have network access to install packages.

Install via npm locally (library installation):

npm install @gongrzhe/server-calendar-mcp

Alternatively, install and use via Smithery for automated setup with Claude as the client:

npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude

Configure the server to run from Claude Desktop by providing your Google credentials and refresh token. Use the following configuration snippet in Claude Desktop to start the MCP server:

{
  "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"
    }
  }
}

Additional configuration and usage notes

Security: keep your Google API credentials secure. Rotate refresh tokens regularly and store sensitive values only in Claude Desktop configuration. Treat the refresh token as a password because it grants access to your Google Calendar.

Tools provided by the server cover five core actions: create_event, get_event, update_event, delete_event, and list_events. Use the MCP client to invoke these actions through natural language commands, aligning with the calendar API’s permission scopes.

Troubleshooting and tips

If you encounter authentication issues, double-check that the Google OAuth 2.0 credentials (Client ID, Client Secret) and the Refresh Token are correctly set in the configuration. Ensure the Calendar API is enabled for your Google Cloud project.

Available tools

create_event

Create a new Google Calendar event with a title, start/end times, description, and location.

get_event

Retrieve details for a specific event using its event ID.

update_event

Update an existing event's title, time, description, or location.

delete_event

Delete an event by its event ID.

list_events

List events within a specified time range, with optional limits and ordering.

Built by

VeilStrat

AI signals for GTM teams