kaiten-mcp

MCP server for Kaiten — gives AI agents access to boards, cards, and properties via Model Context Protocol.

Built on top of kaiten-sdk.

Installation

mise (recommended)

mise installs the latest release binary for your platform:

mise use github:alldmeat/kaiten-mcp

GitHub Release

Download the binary for your platform from the releases page.

From Source

Building from source requires Swift 6.3 or newer.

swift build -c release
# Binary: .build/release/kaiten-mcp

Usage

1. Get a Kaiten API Token

Get your API token at https://.kaiten.ru/profile/api-key.

2. Configure Credentials

Credentials are stored in ~/.config/kaiten/config.json (shared with the CLI):

{
  "url": "https://.kaiten.ru/api/latest",
  "token": ""
}

Or set credentials through MCP after connecting:

• Call kaiten_login with url and token.
• The server starts even without credentials; API tools validate config lazily and return an error telling you to run kaiten_login when credentials are missing.
• Call kaiten_read_logs to get MCP log file path and contents (optionally tail_lines).

3. Connect to Your AI Tool

See the Integration Guide for step-by-step instructions for:

• Claude Desktop
• Claude Code (CLI)
• GitHub Copilot (VS Code)
• GitHub Copilot CLI
• Cursor
• OpenAI Codex CLI
• Windsurf

API Reference

Cards

Spaces