kaiten-mcp-server

MCP server exposing four Kaiten (kaiten.ru) operations as tools:

• list_tasks — list/filter cards (board, column, space, text query, archived)
• move_task — move a card to a given board/column/lane
• set_responsible — set a card's responsible person (owner_id)
• add_comment — add a comment to a card

Built on the Kaiten REST API.

Setup

uv sync

Set credentials as env vars:

export KAITEN_DOMAIN=mycompany        # -> https://mycompany.kaiten.ru/api/latest
# or set the full URL directly:
# export KAITEN_BASE_URL=https://mycompany.kaiten.ru/api/latest
export KAITEN_API_TOKEN=ksh_xxx       # from Kaiten user settings -> API tokens

Run

uv run kaiten-mcp-server

Runs over stdio, ready to be wired into any MCP client.

Wire into Claude Code / Claude Desktop

Add to your MCP config (e.g. claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "kaiten": {
      "command": "uv",
      "args": ["--directory", "/home/corfmann/PycharmProjects/kaiten-mcp-server", "run", "kaiten-mcp-server"],
      "env": {
        "KAITEN_DOMAIN": "mycompany",
        "KAITEN_API_TOKEN": "ksh_xxx"
      }
    }
  }
}

Notes

• list_tasks returns a trimmed summary of each card (id, title, board/column/lane, owner, archived, due_date) to keep responses compact; extend _summarize_card in server.py if you need more fields.
• Kaiten has no dedicated "responsible" field on the card-members endpoint — the responsible person is the card's owner_id, set via PATCH /cards/{id}, which is what set_responsible uses.