Google Calendar Oic

🚀 Google Calendar MCP Server Tool Documentation

This tool provides a Machine-to-Machine Protocol (MCP) interface for Google Calendar. Through this interface, you can perform the following operations:

1. Create an event: Use the createEvent tool to add a new schedule to the calendar.
2. Update an event: Utilize the updateEvent tool to modify the details of an existing event.
3. Delete an event: Remove a specific schedule using the deleteEvent tool.
4. Get the calendar list: Retrieve all accessible calendars with the getCalendars tool.
5. Authentication tool: A new authenticate tool is added, which supports switching between different Google accounts without restarting Claude.

🚀 Quick Start

MCP Message Format

MCP communication uses the JSON-RPC protocol. The specific request format is as follows:

{
  "jsonrpc": "2.0",
  "method": "tool.name",
  "params": {
    "calendarId": "primary", // Calendar ID, default is "primary"
    "event": { ... }, // Specific event information
    ...
  },
  "id": 1
}

Tool Descriptions

createEvent

• Function: Create a new schedule.
• Parameters:
  • calendarId (optional): Specify the target calendar, default is "primary".
  • event: An object containing detailed event information, which must include the summary, description, start, and end fields.

updateEvent

• Function: Update the information of an existing event.
• Parameters:
  • eventId: The ID of the event to be modified.
  • calendarId (optional): The target calendar, default is "primary".
  • event: An object containing the fields to be updated. Fields not provided will remain unchanged.

deleteEvent

• Function: Delete a specified schedule.
• Parameters:
  • eventId: The ID of the event to be deleted.
  • calendarId (optional): The target calendar, default is "primary".

getCalendars

• Function: Get a list of all accessible calendars.
• Return value: An array of objects containing calendar IDs and names.

📚 Documentation

Version History

Version 1.0.6 Update

• Unnecessary authorization scope (scope) settings are removed, optimizing the integration with the Google Calendar API.

Version 1.0.5 Update

• New features:
  • Support creating and modifying recurring events directly in createEvent and updateEvent through the recurrence parameter.
  • Allow users to manage recurring schedules without manual settings.

Version 1.0.4 Update

• Maintenance update to maintain compatibility with the latest dependencies.
• No functional changes, mainly optimizing the internal code structure.

Version 1.0.3 Update

• New features:
  • Introduce the authenticate tool to support re - authentication at runtime.
  • Implement the account switching function, allowing users to change Google accounts without restarting Claude.
  • Provide a manual authentication option for environments where localhost cannot be accessed.
  • Add a console interface for users to input authorization codes.
• Optimizations and improvements:
  • Update the zod dependency to the latest version (3.24.2).
  • Fix multiple potential security and performance issues.

Version 1.0.2 Update

• Fix a bug that may cause errors in calendar access permissions.

Contribution Guide

• Code repository: The project is hosted on GitHub.
• Submit issues: Use Github Issues to report problems or propose suggestions.
• Participate in development: You are welcome to fork the repository and submit pull requests.

Testing Guide

• Testing requirements:
  • Ensure you have a valid Google Calendar account.
  • Configure the correct API key and authorization permissions.
• Testing method:

npm test

📄 License

This project follows the MIT License protocol. The source code can be obtained on Github.

If you have any questions, please contact the support team or visit our official documentation.