Skip to main content
Glama

An MCP server for Kaiten: spaces, boards, cards, comments, checklists, external links, time tracking and a day plan from Claude or any other MCP client. It runs locally over stdio or as a hosted connector, where everyone signs in with their own Kaiten token.

Tools

40 tools, grouped by area:

  • Users: kaiten_get_current_user (the owner of the token, to learn your user id), kaiten_list_users (filter by name or email).

  • Spaces and boards: kaiten_list_spaces, kaiten_get_space, kaiten_list_boards (without space_id it takes KAITEN_DEFAULT_SPACE_ID), kaiten_get_board.

  • Lookups: kaiten_list_columns, kaiten_list_lanes, kaiten_list_card_types, kaiten_list_tags.

  • Cards: kaiten_get_card, kaiten_create_card, kaiten_update_card (only the changed fields), kaiten_move_card (column, lane or board), kaiten_delete_card, kaiten_archive_card.

  • Members and tags: kaiten_add_card_member, kaiten_remove_card_member, kaiten_add_card_tag (by name, creates a missing tag), kaiten_remove_card_tag.

  • External links: kaiten_list_card_external_links, kaiten_add_card_external_link, kaiten_update_card_external_link, kaiten_remove_card_external_link. A link to a merge request belongs here rather than in a comment.

  • Search: kaiten_search_cards, full text and filters; rare API parameters go through extra_params.

  • Comments: kaiten_list_comments, kaiten_create_comment (markdown), kaiten_update_comment, kaiten_delete_comment.

  • Checklists: kaiten_list_checklists, kaiten_add_checklist, kaiten_add_checklist_item, kaiten_update_checklist_item, kaiten_delete_checklist_item.

  • Time tracking: kaiten_list_time_logs, kaiten_add_time_log (minutes), kaiten_delete_time_log.

  • Planning: kaiten_today_tasks (active cards due today or earlier, ASAP first), kaiten_overdue_cards, kaiten_plan_day (overdue and today as ready markdown plus a structured list). Without user_id they take the owner of the token.

Related MCP server: kaiten-mcp

Hosted connector

In Claude: Settings → Connectors → Add custom connector → https://kaiten-mcp.aimuzov.online/mcp. In Claude Code:

claude mcp add --transport http kaiten https://kaiten-mcp.aimuzov.online/mcp

The browser opens a sign-in form for your Kaiten address and API token (Profile → API keys). The server checks the token against Kaiten and puts it inside an encrypted access token, so it is never stored on the server: auth.db keeps only the registered OAuth clients. An address typed into the form has to be a public https host, private and link-local addresses are refused.

Local server

Node 26 or newer. See .mcp.json.example:

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

Without KAITEN_API_URL and KAITEN_API_TOKEN the server asks for them through elicitation on the first API call and keeps them in memory only. A client without elicitation gets an error with a hint to set the variables.

Variable

Default

What it does

KAITEN_API_URL

Kaiten address, /api/latest may be omitted. In --http one address for everyone

KAITEN_API_TOKEN

API token for stdio

KAITEN_DEFAULT_SPACE_ID

Default space

KAITEN_REQUEST_TIMEOUT_MS

30000

Kaiten request timeout, 1000 to 600000

KAITEN_MAX_CONCURRENT_REQUESTS

5

Parallel requests per token, 1 to 20

KAITEN_LOG_LEVEL

info

error, warn, info or debug

KAITEN_LOG_FILE

A log file on top of stderr

A typo in a number or the log level stops the start with the variable's name. .env in the working directory is read too, the environment wins.

Running the connector

kaiten-mcp serve --http is the same server with OAuth 2.1, PKCE and dynamic client registration on infra-mcp-kit. On top of the variables above it needs:

Variable

Default

What it does

PUBLIC_URL

Public address of the connector, required

AUTH_SECRET

Token key, 32 characters or more; changing it logs everyone out

PORT

8080

KAITEN_MCP_DATA_DIR

~/.config/kaiten-mcp

Where auth.db lives

ALLOWED_REDIRECT_URIS

OAuth callbacks besides Claude and loopback

It runs on the projects server in Docker behind the shared Caddy, see deploy/ and .env.example. A release deploys itself.

Development

npm ci
npm start          # stdio straight from the TypeScript sources
npm test           # node --test, the OAuth flow against a fake Kaiten included
npm run typecheck
npm run lint
npm run dev:pages  # the connector pages with Astro HMR
npm run test:ui    # the pages in Chromium: npx playwright install --with-deps chromium

Kaiten API notes

  • Base path /api/latest, Authorization: Bearer <token>.

  • Column type: 1 queue, 2 in progress, 3 done. Card condition: 1 active, 2 archived.

  • 5xx is retried only for GET, PUT and DELETE: a repeated POST could create a card or a time log twice. 429 and 503 with Retry-After are retried for any method, the pause follows the header, at most a minute.

License

MIT

Available Tools

40 tools
kaiten_add_card_memberДобавить участникаC

Добавляет пользователя в участники карточки.

Inputs: card_id (required), user_id (required).

kaiten_add_card_tagДобавить тегA

Добавляет тег к карточке по имени (создаётся при необходимости).

Inputs: name (required), card_id (required).

kaiten_add_checklistДобавить чек-листC

Создаёт новый чек-лист на карточке.

Inputs: name (required), card_id (required).

kaiten_add_checklist_itemДобавить пункт чек-листаC

Добавляет пункт в чек-лист карточки.

Inputs: text (required), card_id (required), checklist_id (required).

kaiten_add_time_logСписать времяC

Добавляет запись учёта времени к карточке. time_spent указывается в минутах.

Inputs: card_id (required), time_spent (required), comment, role_id, +1 more.

kaiten_archive_cardАрхивировать карточкуA

Архивирует карточку (condition = 2), не удаляя её.

Inputs: card_id (required).

kaiten_create_cardСоздать карточкуC

Создаёт новую карточку. Обязательны board_id, column_id и title. Остальные поля опциональны.

Inputs: title (required), board_id (required), column_id (required), asap, +6 more.

kaiten_create_commentДобавить комментарийC

Добавляет комментарий к карточке. Текст поддерживает markdown.

Inputs: text (required), card_id (required).

kaiten_delete_cardУдалить карточкуA

Удаляет карточку по ID. Действие необратимо — используйте осознанно.

Inputs: card_id (required).

kaiten_delete_checklist_itemУдалить пункт чек-листаC

Удаляет пункт чек-листа карточки.

Inputs: card_id (required), item_id (required), checklist_id (required).

kaiten_delete_commentУдалить комментарийC

Удаляет комментарий карточки.

Inputs: card_id (required), comment_id (required).

kaiten_delete_time_logУдалить списание времениC

Удаляет запись учёта времени с карточки.

Inputs: card_id (required), time_log_id (required).

kaiten_get_boardДоскаA

Возвращает доску по ID. Обычно включает вложенные колонки (columns) и дорожки (lanes).

Inputs: board_id (required).

kaiten_get_cardКарточкаB

Возвращает карточку по ID со всеми полями (описание, участники, теги, сроки и т.д.).

Inputs: card_id (required).

kaiten_get_current_userТекущий пользовательA

Возвращает данные текущего пользователя (того, чей API-токен используется). Полезно, чтобы узнать свой user id для планировочных инструментов.

Inputs: no named parameters.

kaiten_get_spaceПространствоB

Возвращает одно пространство по его ID.

Inputs: space_id (required).

kaiten_list_boardsДоски пространстваB

Возвращает доски (boards) внутри пространства. Если space_id не указан — используется KAITEN_DEFAULT_SPACE_ID (если задан).

Inputs: space_id.

kaiten_list_card_typesТипы карточекB

Возвращает доступные типы карточек (card types) компании.

Inputs: no named parameters.

kaiten_list_checklistsЧек-листы карточкиB

Возвращает чек-листы карточки вместе с их пунктами.

Inputs: card_id (required).

kaiten_list_columnsКолонки доскиB

Возвращает колонки (columns) доски. У колонки есть поле type: 1 — очередь, 2 — в работе, 3 — готово.

Inputs: board_id (required).

kaiten_list_commentsКомментарии карточкиC

Возвращает комментарии карточки.

Inputs: card_id (required).

kaiten_list_lanesДорожки доскиC

Возвращает дорожки (lanes / горизонтальные ряды) доски.

Inputs: board_id (required).

kaiten_list_spacesСписок пространствB

Возвращает все доступные пространства (spaces) Kaiten.

Inputs: no named parameters.

kaiten_list_tagsТегиB

Возвращает список тегов компании.

Inputs: no named parameters.

kaiten_list_time_logsСписания времениB

Возвращает записи учёта времени (time logs) по карточке.

Inputs: card_id (required).

kaiten_list_usersСписок пользователейB

Возвращает список пользователей компании. Можно фильтровать по подстроке имени/email через query.

Inputs: limit, query, offset.

kaiten_move_cardПереместить карточкуB

Перемещает карточку в другую колонку/дорожку/на другую доску. Удобная обёртка над update.

Inputs: card_id (required), lane_id, board_id, column_id.

kaiten_overdue_cardsПросроченные карточкиB

Возвращает активные карточки пользователя, срок которых уже прошёл (строго раньше сегодня).

Inputs: role, limit, user_id, board_id, +2 more.

kaiten_plan_dayПлан на деньA

Строит готовый план дня из карточек пользователя: группирует на 'Просрочено' и 'На сегодня', сортирует по приоритету и сроку, и возвращает готовый markdown-текст плюс структурированный список карточек.

Inputs: role, limit, user_id, board_id, +2 more.

kaiten_remove_card_memberУбрать участникаC

Удаляет пользователя из участников карточки.

Inputs: card_id (required), user_id (required).

kaiten_remove_card_tagУбрать тегC

Удаляет тег с карточки по ID тега.

Inputs: tag_id (required), card_id (required).

kaiten_search_cardsПоиск/выборка карточекB

Гибкая выборка карточек по фильтрам. Все фильтры опциональны и комбинируются. Для редких параметров Kaiten API, не вынесенных в явные поля, используйте extra_params. Возвращает массив карточек.

Inputs: limit, query, offset, lane_id, +13 more.

kaiten_today_tasksЗадачи на сегодняA

Возвращает активные карточки пользователя со сроком на сегодня или раньше (по умолчанию включая просроченные). Исключает карточки в колонках типа 'готово'. Отсортировано: сначала ASAP, затем по сроку.

Inputs: role, limit, user_id, board_id, +3 more.

kaiten_update_cardОбновить карточкуB

Обновляет поля карточки. Передавайте только те поля, которые нужно изменить.

Inputs: card_id (required), asap, title, lane_id, +7 more.

kaiten_update_checklist_itemОбновить пункт чек-листаB

Изменяет текст и/или статус (выполнен) пункта чек-листа.

Inputs: card_id (required), item_id (required), checklist_id (required), text, +1 more.

kaiten_update_commentИзменить комментарийC

Изменяет текст существующего комментария.

Inputs: text (required), card_id (required), comment_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 40 tools

    Disambiguation4/5

    Most tools target a clearly distinct resource+action (tags, members, external links, comments, checklists, time logs, planning views). There is mild overlap between kaiten_search_cards, kaiten_today_tasks, kaiten_overdue_cards and kaiten_plan_day, and kaiten_move_card / kaiten_archive_card are wrappers over kaiten_update_card, but the descriptions make the boundaries understandable.

    Naming Consistency4/5

    Consistent kaiten_ prefix with verb_noun structure throughout, and the remove/delete split appears semantic (remove = association like tag/member/link, delete = owned resource like card/comment/checklist item). Minor deviation: card sub-resources put 'card' mid-name (kaiten_add_card_external_link, kaiten_list_card_external_links) while others are verb_resource (kaiten_list_tags), giving slightly inconsistent word order.

    Tool Count2/5

    40 tools is well beyond the comfortable range and includes many near-duplicate CRUD variants across sub-resources. Several could be consolidated (move_card/archive_card into update_card, per-resource list/get pairs), making the surface heavy for an agent to navigate.

    Completeness4/5

    Strong lifecycle coverage for the core domain: cards, comments, checklists and items, tags, members, external links, time logs, plus spaces/boards/columns/lanes/users and planning views. Gaps remain (no delete_checklist, no attachment handling, no board/space creation, no get-single-comment or list-members on a card), but they are workaroundable.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for integrating Kaiten API with Claude Desktop, enabling management of cards, comments, spaces, and boards with advanced features like verbosity control, response format selection, and auto-truncation.
      33
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for interacting with Kaiten project management through its REST API. Enables managing spaces, boards, cards, comments, checklists, tags, and time logs.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Kaiten project management, providing 63 tools for managing cards, comments, checklists, time tracking, and more. Enables AI assistants to interact with Kaiten workspaces through natural language.
      63
      61 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server and CLI tool for interacting with Kaiten project management API, optimized for token efficiency. Enables AI assistants to search, create, update, and manage tasks with minimal token usage.
      61 npm
      MIT