google-calendar-mcp

google-calendar-mcp

3.3

A TypeScript-based Model Context Protocol (MCP) server that allows Claude Desktop to connect to and interact with Google Calendar.

The Google Calendar MCP Server is a TypeScript-based server designed to facilitate the integration of Claude Desktop with Google Calendar. It enables users to connect their Claude Desktop AI to Google Calendar, allowing for seamless interaction with calendar data. The server supports operations such as retrieving calendar lists and events, creating, updating, and deleting events, and fetching upcoming events across all calendars. It employs Google OAuth2 for secure authorization and ensures secure token handling. The server is built with strong typing in TypeScript, ensuring robust and reliable performance. It requires Node.js (v16 or higher), npm or yarn, and Google OAuth2 credentials for setup. The server supports two authentication methods: Google Cloud OAuth for secure production use and direct authentication for simpler development use.

Features

  • Connect Claude Desktop AI to Google Calendar data
  • Authorization with Google OAuth2
  • Retrieve calendar lists and events
  • Create, update, and delete calendar events
  • Secure token handling

Usage with Different Platforms

Node.js

bash
# Start the development server with hot reloading
npm run dev
# or
yarn dev

# Build the TypeScript code
npm run build
# or
yarn build

# Start the production server
npm run start
# or
yarn start

Docker

bash
# Build and run with Docker Compose
docker-compose up -d

Frequently Asked Questions

What are the authentication methods supported?

The server supports Google Cloud OAuth for secure production use and direct authentication for simpler development use.

What should I do if Claude Desktop cannot connect to the MCP server?

Ensure the server is running and accessible, check firewall settings, and verify the server's port matches what Claude Desktop is trying to connect to.

How do I configure Claude Desktop to recognize the MCP server?

Edit the Claude Desktop settings file to include the MCP server configuration, specifying the command, arguments, and environment variables.