Gongrzhe Calendar MCP Server

🚀 Google Calendar MCP Server

The Google Calendar MCP Server is a Claude Desktop Model Context Protocol (MCP) server for Google Calendar integration. It enables AI assistants to manage Google Calendar events through natural language interactions.

✨ Features

• Create calendar events with titles, times, descriptions, and locations.
• Retrieve event details by event ID.
• Update existing events (titles, times, descriptions, locations).
• Delete events.
• List events within a specified time period.
• Fully integrate with the Google Calendar API.
• Secure OAuth2 authentication.

📦 Installation

Installation via Smithery

To automatically install the Google Calendar integration for Claude Desktop via Smithery:

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

Manual Installation

npm install @gongrzhe/server-calendar-mcp

📚 Documentation

Setup

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 “Desktop app” as the application type.
   • Enter a name and click “Create”.
   • Obtain your GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET. c. Get a refresh token:
   • Visit OAuth 2.0 Playground.
   • Click the gear icon (Settings) in the top - right corner.
   • Enable “Use your own OAuth credentials”.
   • Enter your OAuth client ID and client secret.
   • Find “Calendar API v3” in the left panel and select "https://www.googleapis.com/auth/calendar".
   • Click “Authorize APIs” and complete the OAuth process.
   • Click “Exchange authorization code for tokens”.
   • Copy the “Refresh token” - this is your GOOGLE_REFRESH_TOKEN.
2. Configure in Claude Desktop:

{
  "calendar": {
    "command": "npx",
    "args": [
      "@gongrzhe/server-calendar-mcp"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "your_client_id_here",
      "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
      "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
    }
  }
}

💻 Usage Examples

Basic Usage

# Create a new calendar
curl -X POST http://localhost:3000/calendars \
  -H 'Content-Type: application/json' \
  -d '{"name": "My Calendar"}'

# Create an event in a specified calendar
curl -X POST http://localhost:3000/calendars/[CALENDAR_ID]/events \
  -H 'Content-Type: application/json' \
  -d '{"summary": "Meeting", "start": {"dateTime": "2024-01-01T10:00:00"}, "end": {"dateTime": "2024-01-01T11:00:00"}}'

Advanced Usage

# Get all calendars
curl http://localhost:3000/calendars

# Get events of a specific calendar
curl http://localhost:3000/calendars/[CALENDAR_ID]/events

⚠️ Important Note

• The refresh token provides access to your Google Calendar. Keep it secure.
• Do not commit your credentials to the version control system.
• Regularly update and manage your API keys to ensure security.

🤝 Contribution Guidelines

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

📄 License

This project is licensed under the ISC license.

👨‍💻 Author

gongrzhe