Google Calendar MCP Server logo

Google Calendar MCP Server

by takumi0706

Google Calendar MCP Server is an MCP server that integrates Google Calendar with Claude Desktop. It allows Claude to interact with Google Calendar, enabling users to display, create, update, and delete calendar events through natural language.

View on GitHub

Last updated: N/A

What is Google Calendar MCP Server?

Google Calendar MCP Server is an implementation of the Model Context Protocol (MCP) server that connects Google Calendar to Claude Desktop, allowing Claude to manage calendar events.

How to use Google Calendar MCP Server?

To use this server, you need to configure a Google Cloud Project, enable the Google Calendar API, set up OAuth2 credentials, and configure environment variables. Then, add the server configuration to your claude_desktop_config.json file.

Key features of Google Calendar MCP Server

  • Google Calendar integration with Claude Desktop

  • MCP implementation for AI assistant tool integration

  • OAuth2 authentication for secure API access

  • Comprehensive event management (get, create, update, delete)

  • Color support for events

  • STDIO transport for communication

Use cases of Google Calendar MCP Server

  • Creating calendar events using natural language commands

  • Retrieving upcoming events through Claude

  • Updating event details via Claude

  • Deleting events using natural language

  • Integrating calendar functionality into AI workflows

FAQ from Google Calendar MCP Server

How do I configure the Google Calendar API?

You need to create a Google Cloud Project, enable the Google Calendar API, and configure OAuth2 credentials in the Google Cloud Console.

What environment variables are required?

You need to set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REDIRECT_URI. Optionally, you can set TOKEN_ENCRYPTION_KEY, AUTH_PORT, AUTH_HOST, PORT, HOST, and USE_MANUAL_AUTH.

How do I enable manual authentication?

Set the USE_MANUAL_AUTH environment variable to "true". This is useful when localhost is not accessible.

Where are the logs stored?

Logs are stored in the user's home directory at ~/.google-calendar-mcp/logs/.

What do I do if I get an 'Invalid state parameter' error?

Update to version 1.0.3 or later, which fixes the OAuth server lifecycle management. In older versions, you may need to close port 4153 and restart the application.

Google Calendar MCP Server - MCP Server | MCP Directory