Kaiten MCP with adjustable response detail

kaiten-mcp

A fork of a popular Kaiten MCP with 63 tools, adjustable response verbosity and a detailed API-quirks guide for the model

MCP serverRussian stack

amico1285/kaiten-mcpAuthor:Amico1285

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/amico1285-kaiten-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio --env 'KAITEN_API_TOKEN=<your KAITEN_API_TOKEN>' --env 'KAITEN_URL=<KAITEN_URL value>' kaiten -- npx -y kaiten-mcp

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

code --add-mcp '{"name":"kaiten","type":"stdio","command":"npx","args":["-y","kaiten-mcp"],"env":{"KAITEN_API_TOKEN":"<your KAITEN_API_TOKEN>","KAITEN_URL":"<KAITEN_URL value>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "kaiten": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add kaiten --env 'KAITEN_API_TOKEN=<your KAITEN_API_TOKEN>' --env 'KAITEN_URL=<KAITEN_URL value>' -- npx -y kaiten-mcp

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.kaiten]
command = "npx"
args = ["-y", "kaiten-mcp"]
env = { KAITEN_API_TOKEN = "<your KAITEN_API_TOKEN>", KAITEN_URL = "<KAITEN_URL value>" }

If the file already exists, append the block to the end.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "kaiten": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "kaiten-mcp"
      ],
      "environment": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": [
        "-y",
        "kaiten-mcp"
      ],
      "env": {
        "KAITEN_API_TOKEN": "<your KAITEN_API_TOKEN>",
        "KAITEN_URL": "<KAITEN_URL value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

KAITEN_API_TOKENsecret, required
KAITEN_URLrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit c35f098.

Text for your agent

Create a token in your Kaiten profile and add the server to your MCP client config using npx -y kaiten-mcp with the KAITEN_API_TOKEN and KAITEN_URL variables.

Other ways from the author

{
  "mcpServers": {
    "kaiten": {
      "command": "npx",
      "args": ["-y", "kaiten-mcp"],
      "env": {
        "KAITEN_API_TOKEN": "your-api-token",
        "KAITEN_URL": "https://your-company.kaiten.ru"
      }
    }
  }
}

The config snippet from the README.

This is third-party code. Review the repository files before installing.

What it does

The server covers 63 Kaiten operations: cards, comments, time logs, spaces and boards, subtasks, tags, checklists, files, custom fields, users, card members and blockers, external links, sprints. Every tool takes a verbosity parameter (min, normal, max, raw) controlling how much data comes back. It caches reference data with a configurable TTL, retries on 429 and network errors with exponential backoff, and uses idempotency keys for write operations. The project ships an LLM_GUIDE.md describing Kaiten's data model and non-obvious API quirks the author recommends the model read before its first call.

Who it is for. For Kaiten teams that care about fine control over response size and resilience to API hiccups.

Good fit when

You need file uploads and tracking on a card, not just text fields
You want to control response size per call via verbosity
You need retries and write idempotency so failures do not create duplicates

Not a fit when

You want a minimal server, not 63 tools with extra settings: pick a smaller one
Your Kaiten uses OAuth login: the API only supports tokens, and the server reflects that

Example request

Find overdue Kaiten cards and show how much time is logged on them

Limitations

This is a fork of iamtemazhe/mcp-kaiten with the author's fixes, not an independent build from scratch. Deleting a card with logged time first requires deleting the time logs separately. Single author, few stars.

How to disable. Remove the kaiten entry from your MCP client config.

MCP

Transport: stdio
Authentication: API key

Environment variables
Environment variables
KAITEN_API_TOKEN required, secret	API token, bearer
KAITEN_URL required	Kaiten instance URL
KAITEN_DEFAULT_SPACE_ID	Default space ID for card search
KAITEN_ALLOWED_SPACE_IDS	Comma-separated whitelist of accessible space IDs
KAITEN_ALLOWED_BOARD_IDS	Comma-separated whitelist of accessible board IDs

Security check

Uploads and deletes files on cards
Can delete cards, comments and checklists

README in short

The README frames the project as a fork of mcp-kaiten with five waves of fixes (22 new tools, schema repairs, preflight checks), gives a one-command npx quick start, an environment variable table, a tool list across 14 groups, reliability mechanisms (caching, retries, idempotency), and a section on Kaiten API quirks found in practice.

FAQ

What does the verbosity parameter do?

It is a min/normal/max/raw setting controlling response detail, from compact to the full raw API JSON.

Do I need to set a user ID?

No, the current user is resolved automatically from the token.

SiYuan

Official

A self-hosted knowledge base with block-level references and a built-in MCP server for connecting AI agents to your notes

MCP serverMedium risk46.5K

gws

Editors’ pick

A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more

CLIHigh risk31.2K

QMD

Editors’ pick

Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server

CLIMedium riskNo VPN needed30.1K

Taskmaster

Editors’ pick

A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI

MCP serverMedium risk28.1K

Install

What it does

Good fit when

Not a fit when

Example request

Limitations

MCP

Security check

README in short

FAQ

Related

SiYuan

gws

QMD

Taskmaster