MCP Google Calendar Server logo

MCP Google Calendar Server

by iamapark

MCP Google Calendar Server is a server that integrates with Google Calendar based on the Model Context Protocol (MCP). It allows MCP clients like Claude Desktop to add events to Google Calendar.

View on GitHub

Last updated: N/A

What is MCP Google Calendar Server?

This server is a Google Calendar integration server based on the Model Context Protocol (MCP). It enables MCP clients, such as Claude Desktop, to interact with Google Calendar for adding and retrieving events.

How to use MCP Google Calendar Server?

To use this server, you need to clone the repository, install dependencies, configure environment variables with Google Cloud Console credentials, set up Claude Desktop to connect to the server, build the TypeScript code, and restart Claude Desktop. Then, you can use the provided tools like googleAuthLogin, addCalendarEvent, listCalendarEvents, and getTodayDate from Claude to interact with Google Calendar.

Key features of MCP Google Calendar Server

  • Google OAuth 2.0 authentication

  • Adding Google Calendar events

  • Retrieving Google Calendar events (period-based)

  • Today's date retrieval

  • Korean Standard Time (KST) support

  • Detailed error handling and logging

Use cases of MCP Google Calendar Server

  • Adding meeting schedules from Claude

  • Checking upcoming events within a specific timeframe

  • Getting today's date for scheduling purposes

  • Automating calendar management tasks through Claude

  • Integrating Google Calendar with other MCP-compatible applications

FAQ from MCP Google Calendar Server

How do I configure the server to connect to my Google Calendar?

You need to create a project in Google Cloud Console, enable the Google Calendar API, create OAuth 2.0 client ID, and set the client ID and secret in the .env file.

How do I connect the server to Claude Desktop?

You need to create or modify the claude_desktop_config.json file in the Claude Desktop configuration directory and specify the command, arguments, and environment variables for the server.

What tools are available for interacting with Google Calendar?

The server provides tools like googleAuthLogin for authentication, addCalendarEvent for adding events, listCalendarEvents for retrieving events, and getTodayDate for getting today's date.

How do I debug the server?

You can check the Claude Desktop logs, verify the server process execution status, check environment variable settings, and ensure that you are using absolute paths in the configuration.

What kind of errors does the server handle?

The server handles errors related to Google authentication, invalid time formats, missing required parameters, and Google Calendar API call failures.