Gongrzhe Calendar Autoauth MCP Server

🚀 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.

Troubleshooting

Problem 1: Unable to Connect to Google Calendar

• Check the network connection, confirm that the Calendar API is correctly enabled, and ensure that the service account has appropriate permissions.

Problem 2: Incorrect Time Format

• Ensure that all time fields follow the ISO 8601 standard format (e.g., "2024-01-20T10:00:00Z").

🤝 Contribution

Welcome any contributions! Please participate in the project development by submitting a Pull Request.

📄 License

This project is licensed under the ISC license.

👨‍💻 Author

gongrzhe