kaiten-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kaiten-mcp plan my day"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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(withoutspace_idit takesKAITEN_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 throughextra_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). Withoutuser_idthey 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/mcpThe 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 address, | |
| API token for stdio | |
| Default space | |
|
| Kaiten request timeout, 1000 to 600000 |
|
| Parallel requests per token, 1 to 20 |
|
|
|
| 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 address of the connector, required | |
| Token key, 32 characters or more; changing it logs everyone out | |
|
| |
|
| Where |
| 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 chromiumKaiten API notes
Base path
/api/latest,Authorization: Bearer <token>.Column type:
1queue,2in progress,3done. Cardcondition:1active,2archived.5xx is retried only for
GET,PUTandDELETE: a repeatedPOSTcould create a card or a time log twice. 429 and 503 withRetry-Afterare retried for any method, the pause follows the header, at most a minute.
License
Available Tools
40 toolskaiten_add_card_external_linkДобавить внешнюю ссылкуA
Привязывает к карточке внешнюю ссылку (например, на merge request). Предпочтительнее комментария: ссылка отображается как связанный ресурс и не засоряет ленту.
Inputs: url (required), card_id (required), description.
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_external_linksВнешние ссылки карточкиC
Возвращает внешние ссылки (external links) карточки.
Inputs: card_id (required).
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_external_linkУдалить внешнюю ссылкуC
Удаляет внешнюю ссылку карточки по ID ссылки.
Inputs: card_id (required), external_link_id (required).
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_card_external_linkИзменить внешнюю ссылкуC
Изменяет URL и/или подпись внешней ссылки карточки.
Inputs: card_id (required), external_link_id (required), url, description.
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
Scored across 40 tools
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.
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.
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.
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
Related MCP Connectors
Remote MCP for Kanban AI boards—manage projects, tasks, and comments from AI tools.
Agile project management over MCP: boards, epics, roadmap, retros, whiteboards, wiki, metrics
Headless task management for bots, apps and AI agents. Remote MCP server, OAuth or access token.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP 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.33MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for interacting with Kaiten project management through its REST API. Enables managing spaces, boards, cards, comments, checklists, tags, and time logs.1MIT
- AlicenseAqualityDmaintenanceMCP 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.6361 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP 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 npmMIT