Calendar MCP Server logo

Calendar MCP Server

by gongrzhe

The Calendar MCP Server integrates Google Calendar with Claude Desktop, enabling AI assistants to manage calendar events through natural language. It allows for creating, retrieving, updating, and deleting events, providing a seamless calendar management experience.

View on GitHub

Last updated: N/A

What is Calendar MCP Server?

This is a Model Context Protocol (MCP) server that allows Claude Desktop to interact with Google Calendar. It provides a bridge between natural language commands and the Google Calendar API, enabling AI assistants to manage calendar events.

How to use Calendar MCP Server?

First, set up a Google Cloud Project and obtain OAuth 2.0 credentials. Then, configure Claude Desktop with the necessary environment variables (GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN). Finally, use the provided example JSON payloads to interact with the server through Claude Desktop for creating, listing, updating, and deleting events.

Key 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

  • Secure OAuth2 authentication

Use cases of Calendar MCP Server

  • Scheduling meetings and appointments via natural language commands

  • Retrieving upcoming events through AI assistant queries

  • Updating event details using voice commands

  • Automating calendar management tasks within Claude Desktop

FAQ from Calendar MCP Server

How do I get my Google API credentials?

Create a Google Cloud Project, enable the Google Calendar API, and create OAuth 2.0 credentials. Follow the detailed steps in the Setup section of the README.

How do I install the server?

You can install it via Smithery using the provided command, or manually using npm.

What is a refresh token and why is it important?

A refresh token is used to obtain new access tokens without requiring the user to re-authorize the application. It's crucial for maintaining persistent access to the Google Calendar API. Treat it like a password and keep it secure.

How do I configure Claude Desktop to use this server?

Add a 'calendar' configuration block to your Claude Desktop configuration file, specifying the command to run the server and the necessary environment variables for Google API credentials.

What if I encounter issues or have questions?

Please file an issue on the GitHub repository, and the author will provide support.