v2.8.0 - Streamable HTTP Server for Claude.ai Connectors

New Features

Streamable HTTP Server for Claude.ai Connectors

This release adds a new Streamable HTTP transport server that enables the Kimai MCP server to work as a remote connector in Claude.ai, allowing access from web and mobile clients.

Key Features

• Multi-user support: Each user gets their own endpoint (/mcp/{user_slug})
• Server-side credentials: Kimai tokens stored securely in users.json config
• Claude.ai compatible: Works with Claude.ai Connectors (Settings > Connectors > Add custom connector)
• No OAuth required: Simple URL-based access without complex authentication flows

New Files

• streamable_http_server.py - Main Streamable HTTP server implementation
• user_config.py - User configuration management
• config/users.example.json - Example configuration template

Usage

1. Copy and configure config/users.example.json to config/users.json
2. Start the server:

   # Local
   kimai-mcp-streamable --users-config=./config/users.json
   
   # Docker
   docker-compose up -d

3. Add connector in Claude.ai: https://your-domain.com/mcp/{username}

Endpoints

• GET / - Server info
• GET /health - Health check
• GET /users - List available user endpoints
• GET/POST/DELETE /mcp/{user_slug} - MCP endpoint per user

Breaking Changes

• Default Docker command changed from kimai-mcp-server to kimai-mcp-streamable
• Docker compose now requires config/users.json volume mount

To use the legacy SSE server, override the Docker command:

command: ["kimai-mcp-server"]