Calendar MCP Server

🚀 Google Calendar MCP Server

A Claude Desktop Model Context Protocol (MCP) server for Google Calendar integration. This server enables AI assistants to manage Google Calendar events through natural language interaction.

🚀 Quick Start

This Google Calendar MCP Server allows AI assistants to interact with Google Calendar via natural language. You can manage calendar events such as creating, querying, updating, and deleting them.

✨ Features

• Create calendar events with title, time, description, and location.
• Retrieve detailed information by event ID.
• Update existing events (title, time, description, location).
• Delete events.
• List events within a specified time period.
• Fully integrate with the Google Calendar API.
• Secure OAuth2 authentication.

📦 Installation

Automatic Installation via Smithery

Automatically install the Google Calendar integration for Claude Desktop through Smithery:

npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude

Manual Installation

npm install @gongrzhe/server-calendar-mcp

📚 Documentation

Configuration

1. Create a Google Cloud project and obtain credentials:

   a. Create a Google Cloud project:

   • Visit Google Cloud Console.
   • Create a new project or select an existing one.
   • Enable the Google Calendar API for the project.

   b. Create OAuth 2.0 credentials:

   • Go to "APIs & Services" > "Credentials".
   • Click "Create Credentials" > "OAuth client ID".
   • Select the application type as "Desktop app".
   • Enter a name and click "Create".
   • Obtain the client ID and secret.

   c. Use OAuth2 to get an access token:

   • Visit the Google API Console.
   • Create a project and enable the Calendar API.
   • Add an OAuth client ID.
   • Generate an OAuth 2.0 token.

2. Add the following to the Claude Desktop configuration:

{
  "calendar": {
    "enable": true,
    "apiKey": "Your Google Calendar API key",
    "clientId": "Your client ID",
    "clientSecret": "Your client secret"
  }
}

💻 Usage Examples

Basic Usage

Create a Calendar Event

{
  "summary": "Meeting Reminder",
  "start.dateTime": "2024-03-15T10:00:00+08:00",
  "end.dateTime": "2024-03-15T11:00:00+08:00"
}

Get a List of Events

{
  "timeMin": "2024-03-15T00:00:00+08:00",
  "maxResults": 10
}

📄 License

This project is licensed under the ISC License.

⚠️ Important Note

Restart Claude Desktop after installation to apply the configuration. Ensure the security of API keys and client credentials to avoid leakage. Regularly update access tokens to enhance security.

💡 Usage Tip

Contributions are welcome! Please feel free to submit a Pull Request.

Author

gongrzhe