GongRzhe_Calendar-Autoauth-MCP-Server

The Calendar AutoAuth MCP Server is designed to facilitate seamless integration of Google Calendar with AI assistants, specifically within the Claude Desktop environment. It allows users to manage their Google Calendar events through natural language interactions, providing a user-friendly interface for creating, updating, retrieving, and deleting calendar events. The server supports a simple OAuth2 authentication flow, which automatically launches a browser for user authentication, and stores credentials globally for ease of access. It is compatible with both desktop and web application credentials, ensuring flexibility in deployment. The server is built to work with the Google Calendar API, offering full integration and support for various calendar operations. Additionally, it provides Docker support for users who prefer containerized applications.

Features

• Create calendar events with title, time, description, and location
• Retrieve event details by event ID
• Update existing events (title, time, description, location)
• Delete events
• List events within a specified time range

Usage with Different Platforms

install_via_smithery

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

global_authentication

bash
# First time: Place gcp-oauth.keys.json in your home directory's .calendar-mcp folder
mkdir -p ~/.calendar-mcp
mv gcp-oauth.keys.json ~/.calendar-mcp/

# Run authentication from anywhere
npx @gongrzhe/server-calendar-autoauth-mcp auth

local_authentication

bash
# Place gcp-oauth.keys.json in your current directory
# The file will be automatically copied to global config
npx @gongrzhe/server-calendar-autoauth-mcp auth

docker_authentication

bash
docker run -i --rm \
  --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \
  -v mcp-calendar:/calendar-server \
  -e CALENDAR_OAUTH_PATH=/gcp-oauth.keys.json \
  -e "CALENDAR_CREDENTIALS_PATH=/calendar-server/credentials.json" \
  -p 3000:3000 \
  mcp/calendar auth

docker_usage

{
  "mcpServers": {
    "calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-calendar:/calendar-server",
        "-e",
        "CALENDAR_CREDENTIALS_PATH=/calendar-server/credentials.json",
        "mcp/calendar"
      ]
    }
  }
}