Trello MCP Server

🔀 Активный форк. Это поддерживаемый форк kocakli/Trello-Desktop-MCP, объединяющий вклад сообщества из экосистемы форков (kevinhillinger, zonca, dbz-max, maks244, jantman, ThatIanMcShane, josh-argyle). Пул-реквесты приветствуются — см. Credits для ознакомления с вкладом каждого участника. Опубликовано в npm как atlassian-trello-mcp.

Сервер протокола контекста модели (MCP) для Trello, который работает с любым клиентом, поддерживающим MCP — Claude Desktop, Claude Code, Gemini CLI и другими.

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

Быстрый старт

1. Получите учетные данные API Trello

• Перейдите на https://trello.com/app-key

• Скопируйте свой API Key

• Нажмите "Generate a Token" для получения доступа на чтение/запись

2. Установка

Самый простой способ — npx — без клонирования и сборки, просто запустите:

npx atlassian-trello-mcp

Или установите из исходного кода:

git clone https://github.com/agrath/Trello-Desktop-MCP.git
cd Trello-Desktop-MCP
npm install
npm run build

3. Настройте ваш MCP-клиент

Отредактируйте файл конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "atlassian-trello-mcp"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

claude mcp add trello -- npx -y atlassian-trello-mcp

Установите переменные окружения TRELLO_API_KEY и TRELLO_TOKEN или передавайте учетные данные для каждого запроса.

Отредактируйте ~/.gemini/settings.json:

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "atlassian-trello-mcp"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

Сервер использует транспорт stdio. Запускайте с установленными переменными окружения:

TRELLO_API_KEY=your-key TRELLO_TOKEN=your-token npx atlassian-trello-mcp
# or, from a source clone:
TRELLO_API_KEY=your-key TRELLO_TOKEN=your-token node dist/index.js

Related MCP server: fastmcp-trello

Учетные данные

Учетные данные можно предоставить двумя способами:

1. Переменные окружения (рекомендуется): Установите TRELLO_API_KEY и TRELLO_TOKEN

2. Для каждого запроса: Передайте apiKey и token в качестве параметров инструмента (переопределяет переменные окружения)

Доступные инструменты (46)

Доски и списки

Карточки

Комментарии и активность

Метки

Участники карточек

Вложения

Чек-листы

Элементы чек-листа

Поиск

Конфигурация

Режим только для чтения

Установите TRELLO_READ_ONLY=true для отключения всех операций записи. Будут доступны только инструменты чтения/запросов.

{
  "env": {
    "TRELLO_API_KEY": "your-key",
    "TRELLO_TOKEN": "your-token",
    "TRELLO_READ_ONLY": "true"
  }
}

Компактный режим

Некоторые инструменты поддерживают параметр compact (по умолчанию: true), который возвращает минимальный набор полей для уменьшения размера ответа. Установите compact: false для получения полных данных, включая описания, метки, участников и пользовательские поля.

Инструменты с компактным режимом: get_board_details, trello_get_board_cards, trello_get_list_cards, trello_search.

Загрузка вложений-изображений

Когда вызывается get_card и у карточки есть вложения-изображения, сервер загружает их и возвращает в виде встроенных блоков контента изображений MCP вместе с JSON, позволяя клиенту видеть изображения карточки напрямую. Загрузки ограничены URL-адресами Trello (*.trello.com, trello-attachments.s3.amazonaws.com) и ограничены 5 МБ на изображение для снижения рисков SSRF и раздувания полезной нагрузки.

Установите TRELLO_DOWNLOAD_IMAGES=false (или 0/no/off) для полного отключения — сервер пропустит дополнительный вызов getCardAttachments и вернет только текст. По умолчанию включено.

Логирование

Установите TRELLO_MCP_LOGGING=true для включения файлового логирования через Pino. Логи записываются в dist/logs/app.log.

Разработка

Структура проекта

src/
  index.ts              Entry point (credential injection, tool routing)
  server.ts             MCP server factory (read-only mode support)
  tools/
    boards.ts           Board tools (list, details, lists, filter)
    cards.ts            Card tools (CRUD, archive)
    lists.ts            List tools (cards, create list, comments)
    members.ts          Member tools (user boards, member details)
    search.ts           Search tool
    advanced.ts         Labels, attachments, members on cards, custom fields
    checklists.ts       Checklist and check item tools (13 tools)
  trello/
    client.ts           TrelloClient (API calls, retry, rate limiting)
  types/
    trello.ts           TypeScript interfaces
  utils/
    validation.ts       Zod schemas, extractCredentials, extractTrelloId
    logger.ts           Pino file logger
    health.ts           Health check utility
    appInsights.ts      Telemetry (no-op)
tests/
  validation.test.ts    Validation and credential extraction tests
  trelloClient.test.ts  API client tests (mocked fetch)
  tools.test.ts         Tool handler tests (mocked client)

Сборка и тестирование

npm install
npm run build
npm test
npm run type-check

Ключевые паттерны

• Разрешение ID: Все инструменты принимают URL-адреса Trello, короткие ID или полные 24-символьные шестнадцатеричные ID через extractTrelloId()

• Резервные учетные данные: extractCredentials() сначала проверяет аргументы, затем переменные окружения

• Повторные попытки с задержкой: TrelloClient повторяет попытки при ошибках 500/сети (3 попытки, экспоненциальная задержка)

• Ограничение частоты запросов (Rate limiting): Извлекает и возвращает заголовки x-rate-limit-* из каждого ответа

• Валидация: Схемы Zod проверяют все входные данные перед вызовами API

Вклад в проект

Пул-реквесты приветствуются и активно рассматриваются. Этот форк поддерживается активным пользователем Trello, поэтому функции проходят проверку в реальных условиях.

Если вы форкнули оригинальный проект и создали что-то полезное, пожалуйста, отправьте PR сюда, вместо того чтобы поддерживать отдельный форк — всем проще извлечь выгоду из одного хорошо поддерживаемого проекта.

Чтобы внести свой вклад:

1. Форкните этот репозиторий

2. Создайте ветку для функции

3. Добавьте тесты для новой функциональности

4. Запустите npm test и npm run build

5. Отправьте пул-реквест с четким описанием того, что и зачем сделано

Credits

Этот проект является форком kocakli/Trello-Desktop-MCP. Функции и идеи были включены из всей экосистемы форков:

• kocakli -- Оригинальный проект, ребрендинг для независимости от MCP-клиента, исправление логирования в stderr

• kevinhillinger -- Архитектура внедрения учетных данных, удаление меток, управление участниками карточек, архивация карточек, расширенные типы TypeScript, уровень ресурсов

• zonca -- Централизованная обработка учетных данных с резервным копированием через переменные окружения, инструменты управления метками, комплексные модульные тесты, улучшенные типы TypeScript, заменяющие any

• dbz-max -- Поддержка пользовательских полей (пользовательские поля доски + элементы пользовательских полей карточки)

• maks244 -- Концепция режима только для чтения, фильтрация списков по имени, удаление учетных данных из логов телеметрии

• jantman -- Исправление для числовых значений pos, которые отклонялись при отправке в виде строк MCP-клиентами

• ThatIanMcShane -- Обновление @modelcontextprotocol/sdk с 1.0.4 до 1.29.0 для исправления тайм-аутов соединения с текущими релизами Claude Code

• josh-argyle -- Автоматическая загрузка вложений-изображений в ответах get_card в виде встроенных блоков контента изображений MCP (с добавлением списка разрешенных и ограничением размера во время переноса)

Лицензия

MIT