MCP.so
Sign In

Calendar MCP Server

@MCP-Mirror

About Calendar MCP Server

Mirror of

Basic information

Category

Productivity

Transports

stdio

Publisher

MCP-Mirror

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "GongRzhe_Calendar-MCP-Server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@gongrzhe/server-calendar-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Calendar MCP Server?

Calendar MCP Server is a Model Context Protocol (MCP) server that integrates Google Calendar with Claude Desktop. It enables AI assistants to manage Google Calendar events through natural language interactions, handling event creation, retrieval, updating, deletion, and listing within time ranges.

How to use Calendar MCP Server?

Install via Smithery (npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude) or npm (npm install @gongrzhe/server-calendar-mcp). Set up a Google Cloud Project with OAuth 2.0 credentials and a refresh token. Configure the server in Claude Desktop using environment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN.

Features of Calendar MCP Server

  • Create calendar events with title, time, description, and location
  • Retrieve event details by event ID
  • Update existing events (title, time, description, location)
  • Delete events
  • List events within a specified time range
  • Full integration with Google Calendar API via secure OAuth2 authentication

Use cases of Calendar MCP Server

  • Schedule meetings or appointments via natural language in Claude Desktop
  • Retrieve event details without opening Google Calendar manually
  • Modify or cancel events using conversational AI
  • View your day’s or week’s agenda by listing events in a time range

FAQ from Calendar MCP Server

What does Calendar MCP Server require to run?

You need a Google Cloud Project with the Calendar API enabled, OAuth 2.0 credentials (client ID and secret), and a refresh token obtained from the OAuth 2.0 Playground. The server runs via npx or a local npm installation.

How does authentication work?

The server uses OAuth2 with your own credentials. You must provide GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN as environment variables. The refresh token grants access to your Google Calendar.

Where are calendar events stored?

Events are stored in your Google Calendar account. The server acts as a bridge; no data is stored locally beyond temporary API calls.

How do I keep my credentials secure?

Keep your Google API credentials secret, rotate refresh tokens regularly, store sensitive info in Claude Desktop configuration, and never share or commit credentials to version control.

What transport and communication does this server use?

The server communicates via the MCP protocol over standard input/output when launched as a command-line process by Claude Desktop.

Comments

More Productivity MCP servers