Trello MCP
Provides tools for interacting with Trello boards, lists, cards, checklists, comments, labels, custom fields, members, and search, enabling management of Trello workspaces and card workflows.
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., "@Trello MCP create a card in my Project board for the new landing page due Friday"
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.
Trello MCP
MCP-сервер для Trello: доски, списки, карточки, чек-листы, комментарии, поиск.
Установка
npm install && npm run build
claude mcp add --scope user trello -- node /абсолютный/путь/к/build/index.js
# или без клонирования: claude mcp add --scope user trello -- npx -y github:kholodniakruslan/trello-mcpRelated MCP server: trello-mcp
Шаг 0. API-ключ (один раз, вручную)
Trello выдаёт ключ только владельцу аккаунта, это нельзя автоматизировать.
В Trello должна быть рабочая область (Workspace). Если нет: «Создать» → «Создать рабочую область».
https://trello.com/power-ups/admin/new → «Мое приложение не использует возможности улучшения» → название, рабочая область, email, автор → «Создать».
«Авторизация в Trello» → «Создать новый API-ключ» → «Сгенерировать API-ключ».
В «Одобренные ресурсы» добавьте
http://localhost:8765(нужно только для автоматического режима).Скопируйте «Ключ API» (32 символа) в
~/.config/trello-mcp/config.json:{ "apiKey": "ваш_ключ" }или задайте переменную окружения
TRELLO_API_KEY.
Секретный ключ (64 символа) серверу не нужен.
Подключение аккаунта: выберите способ
Пока Trello не подключён, любой инструмент отвечает сообщением с выбором. Подключиться можно инструментом
trello_connect.
Автоматически: trello_connect {"mode":"auto"}
Что происходит (каждый шаг приходит в виде live-лога и в итоговом ответе):
Проверка API-ключа.
Запуск локального приёмника токена на
localhost:8765.Открытие браузера со страницей согласия Trello, вам нужно нажать «Разрешить».
Браузер возвращает токен на локальный адрес.
Проверка токена запросом к Trello.
Токен сохраняется в
~/.config/trello-mcp/config.json(права 600).Вкладка подключения закрывается автоматически (на macOS через AppleScript: Chrome, Safari, Brave, Edge, Arc и др.; на других ОС страница пробует закрыться сама). При первом запуске macOS может спросить разрешение на управление браузером.
Если браузер не открылся, ссылка есть в логе. Ожидание подтверждения: 3 минуты.
Вручную: trello_connect {"mode":"manual"}
Вызов без
tokenвернёт инструкцию и ссылку.Откройте ссылку в браузере, где вы вошли в Trello, нажмите «Разрешить».
Скопируйте показанный токен (~76 символов).
Вызовите
trello_connect {"mode":"manual","token":"<токен>"}: сервер проверит токен и сохранит его.
Режим по умолчанию
Чтобы не выбирать каждый раз: TRELLO_AUTH_MODE=auto|manual или "authMode" в config.json.
С auto сервер сам запускает подключение при первом же вызове любого инструмента.
Язык сообщений
Сервер отвечает на том языке, на котором вы пишете, а если определить не удалось, на языке системы, иначе на английском. Поддерживаются английский, русский и украинский (инструкции, лог подключения, страница в браузере).
Порядок выбора:
TRELLO_LANGили"lang"в config.json: язык закреплён принудительно, остальное игнорируется.Параметр
lang: на каждом вызове инструмента Claude передаёт код языка вашего сообщения (ru,uk,en…), сервер запоминает его на сессию. Сервер не видит ваш текст, поэтому это делает модель по инструкции сервера.Язык системы:
LC_ALL,LC_MESSAGES,LANG, затем локаль ОС.Английский.
Для языка без словаря (например, es) сообщения идут на английском, а Claude пересказывает их на вашем языке.
Описания инструментов всегда английские: их читает модель, а не пользователь. Данные Trello не переводятся.
Добавить язык: словарь в src/i18n.ts (тест npm test проверит, что в нём есть все ключи).
Статус и отладка
trello_status показывает, подключён ли сервер, настроен ли ключ, режим по умолчанию, язык сообщений и последние 30 строк лога.
Переподключение: trello_connect с force: true.
Отозвать доступ: trello.com → Аккаунт → Настройки → Приложения.
Переменные окружения
Переменная | Назначение |
| API-ключ (приоритетнее файла) |
| токен (приоритетнее файла) |
|
|
| порт локального приёмника (по умолчанию 8765) |
| принудительный язык сообщений: |
Инструменты (40)
Подключение: trello_status, trello_connect.
Доски: list_boards, get_board, create_board, update_board, delete_board, copy_board, get_board_members.
Списки: get_lists, create_list, update_list (имя, позиция, архив), archive_list, copy_list.
Карточки: get_cards, get_card, create_card, update_card (в т.ч. перенос на другую доску, даты начала и срока),
copy_card, delete_card, set_cover, add_comment, get_comments, add_attachment.
Метки: get_labels, create_label, add_label, remove_label.
Чек-листы: create_checklist, add_checklist_item, set_checkitem_state, delete_checklist.
Пользовательские поля: get_custom_fields, create_custom_field (text, number, date, checkbox, list; Power-Up включается сам),
set_custom_field (пустая строка очищает значение).
Участники: get_board_members, invite_member, assign_member, unassign_member, remove_member_from_board.
Поиск: search (с limit, page, boardId).
Большие доски: пагинация и фильтры
get_cards без limit возвращает массив. С limit (и offset) возвращает
{total, offset, returned, hasMore, cards}: повторяйте вызов с offset += limit, пока hasMore истинно.
filter = open | closed (архив) | all; compact=true убирает описания. Читается до 1000 карточек.
get_comments листается через limit и before (id последнего комментария предыдущей страницы).
Подсказки клиенту и надёжность
Чтение помечено readOnly, необратимые удаления (delete_card, delete_board, delete_checklist,
remove_member_from_board) помечены destructive. invite_member отправляет приглашение на email: вызывайте его
только по явной просьбе. При лимите Trello (HTTP 429) запрос повторяется до 3 раз, таймаут запроса 30 секунд.
Установка и запуск через npx
Прямо из GitHub, без аккаунта npm (сборка выполняется при установке):
claude mcp add --scope user trello -- npx -y github:kholodniakruslan/trello-mcpИз локальной копии: npm install && npm run build, затем
claude mcp add --scope user trello -- node /абсолютный/путь/build/index.js.
Пакет для реестра npm (claude-trello-mcp-server) собирается и проверяется командой npm pack; для публикации
(npm publish --access public) в аккаунте npm должна быть включена двухфакторная аутентификация.
Самопроверка
npm test создаёт временные доски, прогоняет инструменты, проверяет результаты и удаляет все эти доски по их id.
Нужно подключённое состояние Trello (см. выше).
Available Tools
40 toolsadd_attachmentB
Attach a URL (link) to a card.
Inputs: url (required), cardId (required), lang, name.
add_checklist_itemC
Add an item to an existing checklist.
Inputs: name (required), checklistId (required), lang, checked.
add_commentC
Add a comment to a card.
Inputs: text (required), cardId (required), lang.
add_labelC
Attach an existing label to a card.
Inputs: cardId (required), labelId (required), lang.
archive_listB
Archive (close) a list.
Inputs: listId (required), lang.
assign_memberB
Assign a board member to a card (get ids from get_board_members).
Inputs: cardId (required), memberId (required), lang.
copy_boardB
Copy a board. With includeCards=true (default) the cards are copied too.
Inputs: name (required), boardId (required), lang, includeCards.
copy_cardB
Copy a card (with checklists, labels, attachments, comments, members) into a list, possibly on another board.
Inputs: cardId (required), listId (required), pos, lang, +1 more.
copy_listB
Copy a list with all its cards onto a board (the same or another one).
Inputs: listId (required), boardId (required), lang, name.
create_boardC
Create a new board.
Inputs: name (required), desc, lang.
create_cardC
Create a card in a list.
Inputs: name (required), listId (required), due, pos, +5 more.
create_checklistC
Add a checklist to a card, optionally with items.
Inputs: name (required), cardId (required), lang, items.
create_custom_fieldA
Create a custom field on a board (enables the Custom Fields Power-Up first if needed). For type=list pass options.
Inputs: name (required), type (required), boardId (required), lang, +1 more.
create_labelC
Create a label on a board.
Inputs: name (required), boardId (required), lang, color.
create_listC
Create a list on a board.
Inputs: name (required), boardId (required), pos, lang.
delete_boardADestructive
PERMANENTLY delete a board with all its lists and cards. Cannot be undone; prefer update_board with closed=true.
Inputs: boardId (required), lang.
delete_cardADestructive
Permanently delete a card. This cannot be undone; prefer update_card with closed=true.
Inputs: cardId (required), lang.
delete_checklistBDestructive
Delete a checklist from a card. Cannot be undone.
Inputs: checklistId (required), lang.
get_boardCRead-only
Get a board's details.
Inputs: boardId (required), lang.
get_board_membersARead-only
List the members of a board (ids are needed for assign_member).
Inputs: boardId (required), lang.
get_cardBRead-only
Get a card's full details, including checklists and members.
Inputs: cardId (required), lang.
get_cardsARead-only
Get the cards in a list, or on a board (provide exactly one of listId/boardId). Returns an array. For big boards paginate with limit and offset: the result is then {total, offset, returned, hasMore, cards}; call again with offset += limit while hasMore is true. filter: open (default), closed (archived) or all. compact drops descriptions and labels to save space. Reads up to 1000 cards.
Inputs: lang, limit, filter, listId, +3 more.
get_commentsARead-only
Get the comments on a card, newest first. Page with limit and before (id of the last comment of the previous page).
Inputs: cardId (required), lang, limit, before.
get_custom_fieldsARead-only
List the custom fields defined on a board (empty if the Custom Fields Power-Up is not enabled).
Inputs: boardId (required), lang.
get_labelsCRead-only
Get the labels defined on a board.
Inputs: boardId (required), lang.
get_listsCRead-only
Get the lists on a board.
Inputs: boardId (required), lang, filter.
invite_memberA
Invite a person to a board by email. SIDE EFFECT: Trello sends an invitation email to that address, so only call this when the user explicitly asked for this exact invitation.
Inputs: email (required), boardId (required), lang, type, +1 more.
list_boardsCRead-only
List the boards of the current Trello user.
Inputs: lang, filter.
remove_labelA
Detach a label from a card (the label itself stays on the board).
Inputs: cardId (required), labelId (required), lang.
remove_member_from_boardBDestructive
Remove a member from a board (they lose access to it).
Inputs: boardId (required), memberId (required), lang.
searchCRead-only
Search Trello for cards and boards.
Inputs: query (required), lang, page, limit, +2 more.
set_checkitem_stateC
Mark a checklist item complete or incomplete.
Inputs: state (required), cardId (required), checkItemId (required), lang.
set_coverA
Set a card's cover: a colour, an existing attachment as an image, or remove the cover (remove=true).
Inputs: cardId (required), lang, size, color, +2 more.
set_custom_fieldA
Set a custom field value on a card. value is a string: text as is; number as digits; date as ISO 8601; checkbox as true/false; list as the option's text. Empty string clears the value.
Inputs: value (required), cardId (required), fieldId (required), lang.
trello_connectA
Connect to Trello. mode=auto: opens the browser, the user clicks Allow, the token is captured and saved automatically. mode=manual: without token returns step-by-step instructions; with token verifies and saves it. Ask the user which mode they prefer before calling.
Inputs: mode (required), lang, force, token.
trello_statusARead-only
Show Trello connection status: whether the API key and token are set, the auth mode, and the recent connection log.
Inputs: lang.
unassign_memberA
Remove a member from a card (they stay on the board).
Inputs: cardId (required), memberId (required), lang.
update_boardB
Rename a board, change its description, or close (archive) / reopen it.
Inputs: boardId (required), desc, lang, name, +1 more.
update_cardA
Update a card: rename, change description/due/start date, move to another list (and, with boardId, to another board), or archive.
Inputs: cardId (required), due, desc, lang, +6 more.
update_listA
Rename a list, change its position (top, bottom, or a number), or archive/unarchive it.
Inputs: listId (required), pos, lang, name, +1 more.
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 (get_card vs create_card vs copy_card vs delete_card, add_label vs remove_label, assign_member vs unassign_member). A few boundaries blur: archive_list overlaps with update_list's archive/unarchive, and delete_board/delete_card duplicate the close-flag behavior of update_board/update_card, though descriptions steer users to the safer option.
Predominantly a verb_noun pattern (get_board, create_card, add_comment, copy_list, set_custom_field) with snake_case throughout. Minor deviations: the prefixed auth tools trello_status/trello_connect, the bare verb 'search', and inconsistent 'checkitem' vs 'checklist_item' naming.
40 tools is heavy for an MCP surface and exceeds the threshold where an agent can hold the catalog comfortably in context. While Trello is a broad domain, several tools (auth, copy variants, separate archive/delete paths) inflate the set beyond what is strictly needed.
Core lifecycle for boards, lists, cards, labels, members, checklists, comments and custom fields is covered. However, sub-resources have add/set operations without their counterparts: no delete/update checklist item, no update/delete label, no remove attachment, no edit/delete comment, and no delete custom field — forcing dead ends.
Maintenance
Related MCP Connectors
A todo and task board in kanban form, driven from chat with full CRUD.
Task manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.
Read and manage your EasyKanban kanban boards: to-do summaries, create, update, and move cards.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Trello boards, lists, and cards through the Trello REST API. Supports board management, card operations, member management, labels, and checklists through natural language.1MIT
- FlicenseAqualityDmaintenanceEnables AI assistants to manage Trello boards, lists, cards, comments, checklists, labels, and members through natural language.16-
- AlicenseNot gradedqualityCmaintenanceEnables managing Trello boards, lists, cards, labels, and members through natural language from any MCP-compatible client.1MIT
- AlicenseBqualityDmaintenanceConnects Trello with AI assistants to manage boards, lists, cards, and comments via natural language.117MIT