Gongrzhe Calendar Autoauth MCP Server

An MCP server that provides Google Calendar integration for the Claude desktop application, supporting automatic authentication and natural language interaction to manage calendar events

Schedule management Developer tools #Calendar Management #Automatic Authentication #Natural Language #Event Synchronization Remote .TypeScript

rating : 2 points

downloads : 8.5K

update time : 2025-04-29

Open Site

What is the Calendar Automatic Authentication MCP Server?

This is an MCP server integrated with the Google Calendar API, supporting the creation, update, deletion, and retrieval of calendar events through natural language. It provides an automated OAuth2 authentication process, eliminating the need to manually handle complex authorization steps.

How to use the Calendar Automatic Authentication MCP Server?

You can complete the configuration and start using it in just a few steps. First, you need to create a Google Cloud project and obtain OAuth credentials; then, run the authentication process and integrate it into Claude Desktop.

Use Cases

Suitable for individuals and teams that need to efficiently manage their schedules, such as meeting arrangements, event planning, and daily task tracking.

Main Features

Create Calendar Event

Supports setting the event title, time, description, and location.

List Calendar Events

Retrieve events in the calendar by time range.

Update Calendar Event

Modify the title, time, description, or location of an existing event.

Delete Calendar Event

Remove a specific calendar event by its event ID.

Automatic OAuth Authentication

Simplify the authentication process and support automatic browser login.

Advantages

No need to manually handle OAuth authentication, easy to operate.

Supports multiple platforms (desktop and web applications).

Globally store credentials for easy reuse.

Compatible with the Google Calendar API, powerful in functionality.

Limitations

Requires pre - configuration of a Google Cloud project.

Depends on the network environment and cannot be used without an internet connection.

Only supports authorized Google accounts.

How to Use

Create a Google Cloud Project

Go to the Google Cloud Console, enable the Google Calendar API, and generate OAuth credentials.

Download and Place OAuth Credentials

Save the generated `gcp - oauth.keys.json` file to the `~/.calendar - mcp/` directory.

Run the Authentication Process

Execute the command to start authentication and save the credentials.

Configure Claude Desktop

Add the MCP server address to the configuration file.

Usage Examples

Create a New Event

Example: Schedule a team meeting.

List Events in the Next Year

Example: Retrieve all events in the next year.

Frequently Asked Questions

How to solve the problem of lost OAuth credentials?

How to update an existing calendar event?

Does it support multiple Google accounts?

Related Resources

GitHub Repository

View the source code and contribution guidelines.

Official Documentation

Gain an in - depth understanding of the functions and usage of the MCP server.

Smithery Installation Guide

Quickly start installation and usage.

🚀 Google Calendar AutoAuth MCP Server

A Model Context Protocol (MCP) server for integrating Google Calendar into Claude Desktop, supporting automatic authentication. This server provides functions to create, read, update, and delete calendar events.

🚀 Quick Start

This MCP server is designed to integrate Google Calendar into Claude Desktop, offering seamless calendar event management with automatic authentication.

✨ Features

Create Events: Supports specifying the title, start time, end time, description, and location.
List Events: Allows querying calendar events within a specific time range and supports sorting by start time.
Update Events: Permits modifying the event's title, time, and other attributes.
Delete Events: Enables deletion by specifying the event ID.

📦 Installation

1. Download the Server

Download the MCP server from the GitHub repository:

git clone https://github.com/yourusername/calendar-mcp-server.git
cd calendar-mcp-server

2. Install Dependencies

Install the required Python packages:

pip install google-auth google-auth-oauthlib googleapis-common-protos google-resumable-media

3. Configure the Calendar API

Create a project in the Google Cloud Console and enable the Calendar API. Download the service-account.json file and place it in the project's root directory.

💻 Usage Examples

Basic Usage

Create an Event

{
  "summary": "Team Meeting",
  "start": {
    "dateTime": "2024-01-20T10:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "description": "Weekly team synchronization",
  "location": "Meeting Room A"
}

List Events

{
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z",
  "maxResults": 10,
  "orderBy": "startTime"
}

Update an Event

{
  "eventId": "event123",
  "summary": "Updated Meeting Title",
  "start": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T12:00:00Z"
  }
}

Delete an Event

{
  "eventId": "event123"
}

📚 Documentation

Security Precautions

⚠️ Important Note

OAuth Credential Security: Ensure that the service-account.json file is not leaked or committed to the version control system.

Permission Management: Regularly review and clean up unused API access permissions.