G2N MCP Google Calendar SSE Server

🌎 This README is available in multiple languages:

• 🇺🇸 English
• 🇧🇷 Portuguese

Overview

The G2N MCP Google Calendar SSE Server is a Model Context Protocol (MCP) server implementation that provides Google Calendar integration through Server-Sent Events (SSE). This server exposes Google Calendar functionality as tools that can be used by AI models and applications like Cursor, Claude, and n8n to interact with Google Calendar.

Built with the latest MCP SDK version, this server provides robust integration between MCP-compatible models and Google Calendar services.

Features

The server provides the following MCP tools for Google Calendar management:

• list-calendars: List all available calendars
• get-calendar: Get details of a specific calendar
• list-events: List events from a calendar with filtering options
• get-event: Get detailed information about a specific event
• create-event: Create a new calendar event
• update-event: Update an existing calendar event
• delete-event: Delete a calendar event
• list-colors: List available colors for events and calendars

What’s New in v1.1.0

• Comprehensive logging system with configurable log levels
• Request/response logging middleware for better monitoring
• SSE heartbeat implementation for stable connections
• Enhanced error handling and debugging capabilities
• Improved Docker configuration with proper data directory permissions
• Enhanced OAuth flow with better token management
• Code refactoring for better maintainability

What’s New in v1.0.1

• First stable release
• Production-ready with Docker and Docker Swarm support
• Enhanced environment variables configuration
• Improved connection URLs for different deployment scenarios
• Better documentation for n8n integration
• Traefik configuration guidelines
• Multi-platform Docker images (amd64, arm64, arm/v7)

Getting Started

Prerequisites

• Docker and Docker Compose installed
• Google Cloud project with Calendar API enabled
• OAuth 2.0 Client ID and Client Secret

Environment Variables

The server uses the following environment variables:

PORT=3001                                # Server port (default: 3001)
PUBLIC_URL=https://your-domain.com       # Public URL for OAuth callbacks
GOOGLE_CLIENT_ID=${GOOGLE_CLIENT_ID}     # Google OAuth Client ID
GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET} # Google OAuth Client Secret
OAUTH_REDIRECT_PATH=/oauth/callback      # OAuth callback path (default: /oauth/callback)

Important Notes:

• When using Traefik, make sure to configure it to point to the port specified in the PORT environment variable
• This is crucial for successfully receiving the Google refresh token
• The PUBLIC_URL must be internet-accessible for OAuth callbacks to work

Authentication Flow

1. Start the server using Docker or directly
2. Navigate to the /auth endpoint in your browser