Calendar MCP

🚀 Google Calendar Automatic Authorization MCP Server

This is an MCP (Machine Control Protocol) server designed for the automated management of Google Calendar. It supports functions such as creating, updating, deleting, and querying calendar events. The server integrates an automatic authorization feature, streamlining the interaction process with the Google Calendar API.

✨ Features

• Automated Authorization: Users can obtain long - term access tokens through simple authentication, eliminating the need to manually handle the OAuth process.
• High Availability: It employs an efficient API design and a reliable network communication mechanism to ensure the stable operation of the service.
• Scalability: It supports multi - threaded processing and can handle calendar requests from multiple users simultaneously.

📦 Installation

Install Dependencies

1. Ensure that Python 3.6 or a higher version is installed on your system.
2. Install the necessary Python libraries:

   pip install google-api-python-client oauth2client flask
   

Configuration Steps

1. Download the project code and extract it to the specified directory.
2. Configure environment variables:
   • Set GC_CREDENTIALS to the path of the file containing OAuth credentials.
   • Set GC_PROJECT_ID to the Google Cloud project ID of the target project.

📚 Documentation

Event Management

• Create an Event: Supports passing detailed information in JSON format, including the title, time, location, etc.

  {
    "summary": "Meeting",
    "start_time": "2024-05-15T14:00:00",
    "end_time": "2024-05-15T16:00:00"
  }
  

• Update an Event: Specify the item to be modified by the event ID and provide new detailed information.
• Delete an Event: Use the event ID to directly remove a specific item from the calendar.

Calendar Synchronization

• Bulk Import: Supports importing multiple events at once to improve data migration efficiency.
• Incremental Update: Only synchronizes the changed parts, reducing network traffic and server load.

Security Mechanisms

• Credential Encryption: All OAuth credentials are encrypted using AES to ensure secure storage.
• Access Control: Role - based permission management prevents unauthorized operations.
• Audit Logs: Records all API call histories for subsequent tracking and analysis.

💻 Usage Examples

Basic Usage

# Create a new event
curl -X POST \
     http://localhost:5000/api/events \
     -H "Content-Type: application/json" \
     -d '{"summary":"Project Meeting","start_time":"2024-05-16T10:00:00","end_time":"2024-05-16T11:30:00"}'

# Query a specific event
curl -X GET \
     http://localhost:5000/api/events/abc123xyz456

📚 Documentation

FAQs

1. How to handle expired authorization?
   • The server automatically detects the token expiration time and refreshes it upon expiration.
2. Can it support multiple calendar accounts?
   • Yes, each user has an independent calendar storage space to ensure data isolation.
3. How to improve query efficiency?
   • Using filter parameters (such as time range and event tags) can significantly improve the query speed.

Project Documentation

• For detailed interface definitions, please refer to the API documentation.
• For example code and usage tutorials, please visit the Wiki page.

🤝 Contribution and Support

We welcome you to submit Pull Requests or report issues. For commercial support, please contact the project maintainers.

Thank you for choosing our Google Calendar Automatic Authorization MCP Server. We look forward to your feedback and suggestions!