Calendar MCP Server logo

Calendar MCP Server

by gongrzhe

The Calendar MCP Server is a Model Context Protocol (MCP) server designed for Google Calendar integration within Claude Desktop. It allows AI assistants to manage Google Calendar events through natural language interactions.

View on GitHub

Last updated: N/A

What is Calendar MCP Server?

This server is a Model Context Protocol (MCP) server that enables Claude Desktop to interact with Google Calendar. It provides a bridge for AI assistants to create, read, update, and delete calendar events using natural language.

How to use Calendar MCP Server?

To use the server, you need to install it either via Smithery or manually using npm. Then, configure Claude Desktop with your Google API credentials (client ID, client secret, and refresh token). Example usage includes creating, listing, updating, and deleting events using specific JSON formats.

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 AI assistant

  • Managing personal or team calendars through natural language commands

  • Automating calendar event creation and updates

  • Integrating calendar functionality into Claude Desktop workflows

FAQ from Calendar MCP Server

How do I get Google API credentials?

You need to create a Google Cloud Project, enable the Google Calendar API, and create OAuth 2.0 credentials. Refer to the Setup section in the README for detailed steps.

What is a refresh token and how do I get it?

A refresh token is used to obtain access tokens to interact with the Google Calendar API. You can obtain it using the OAuth 2.0 Playground.

How do I install the server?

You can install it using Smithery or manually using npm. Follow the instructions in the Installation section of the README.

How do I configure Claude Desktop to use this server?

You need to add a 'calendar' configuration block to your Claude Desktop settings, specifying the command, arguments, and environment variables (Google API credentials).

What security measures should I take?

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