delorenj/mcp-server-trello

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards.

MCP Server Trello – AI‑friendly Trello bridge

What it is – Bun 기반의 소형 서버로, Model Context Protocol (MCP)을 구현합니다. Trello REST API를 래핑하여 AI 에이전트가 마치 네이티브 함수처럼 호출할 수 있는 57개의 타입형 도구(예: get_card, add_checklist_item, watch_card)를 노출합니다. 서버는 인증, 속도 제한, 입력 유효성 검사를 처리하며 데이터를 JSON 또는 즉시 붙여넣을 수 있는 markdown 형식으로 반환합니다.

Why it matters – 많은 AI 에이전트 프레임워크(Claude Desktop, Cursor 등)는 팀의 프로젝트 보드를 읽거나 쓸 수 있는 신뢰할 수 있는 방법이 필요합니다. 이 서버는 에이전트가 커스텀 HTTP 코드를 작성하지 않고도 보드에 대한 full 액세스 권한을 갖게 하며 다음과 같은 고수준 헬퍼를 추가합니다:

Acceptance‑criteria extraction (get_acceptance_criteria)은 적절한 체크리스트(AC, DoD 등)를 자동으로 찾아 완료 퍼센트를 보고합니다.
Watch tools (watch_card, watch_list)는 Trello 활동을 에이전트의 알림 스트림으로 푸시합니다.
Dynamic board/workspace switching을 통해 동일한 서버가 재시작 없이 여러 프로젝트를 지원할 수 있습니다.

Key features

카드, 리스트, 보드, 체크리스트, 댓글, 첨부 파일, 라벨, 커스텀 필드에 대한 완전한 CRUD.
내장된 속도 제한 처리(API 키당 10초당 300회 요청, 토큰당 10초당 100회 요청).
타입 안전 TypeScript 구현 – 에이전트는 적절한 인자 스키마를 받습니다.
멀티 테넌트 보안을 위한 선택적 환경 변수 샌드박싱 (TRELLO_ALLOWED_WORKSPACES).
사람이 읽기 쉬운 컨텍스트를 위한 카드 데이터의 Markdown 내보내기.
bunx 또는 npx로 실행할 수 있는 단일 npm 패키지 (@delorenj/mcp-server-trello)로 배포됨.

How to get it running

Install – npm i -g @delorenj/mcp-server-trello (또는 MCP 클라이언트에서 패키지를 참조하기만 하면 됩니다. 클로닝은 필요 없습니다).
Configure – TRELLO_API_KEY와 TRELLO_TOKEN이 포함된 .env 파일을 생성합니다 (https://trello.com/app-key에서 획득 가능). 선택적 변수를 통해 기본 보드, 워크스페이스, 프록시를 설정하거나 허용된 워크스페이스를 제한할 수 있습니다.

Add to an MCP client – 예: Claude Desktop의 mcpServers 설정:

{
  "trello": {
    "command": "bunx",
    "args": ["@delorenj/mcp-server-trello"],
    "env": {"TRELLO_API_KEY": "…", "TRELLO_TOKEN": "…"}
  }
}

Start – bunx @delorenj/mcp-server-trello (또는 npx …). 서버는 MCP 레지스트리에 자신을 등록하므로, 레지스트리를 인식하는 모든 클라이언트가 자동으로 이를 발견할 수 있습니다.
Use the tools – 에이전트는 README에 표시된 JSON 페이로드를 사용하여 노출된 도구를 이름으로 호출합니다 (예: { "name": "get_card", "arguments": { "cardId": "abc123" } }). 응답에는 풍부한 데이터 구조가 포함되며, 요청 시 markdown 렌더링을 제공합니다.

Skill package – 이 리포지토리는 BMAD 호환 skill 디렉토리도 함께 제공합니다. skill을 설치하면 서버의 도구가 에이전트의 스킬 세트에 나타나며, 제공된 install.sh 스크립트는 Bun이 있는 경우 서버를 로컬에서 빌드합니다.

Typical workflow

1. list_boards → pick a board ID
2. set_active_board (or set_active_workspace)
3. get_card / get_checklist_items / get_acceptance_criteria
4. update_checklist_item / move_card / add_comment …
5. watch_card to get live updates

Who should use it – Trello 보드를 읽거나 수정해야 하는 AI 어시스턴트를 구축하는 팀(프로젝트 관리 봇, 스프린트 계획 에이전트, 자동화된 회고) 및 가공되지 않은 HTTP 호출 대신 타입형, 속도 제한이 적용된 MCP 준수 인터페이스를 원하는 모든 사람.

Links

npm: https://www.npmjs.com/package/@delorenj/mcp-server-trello
MCP Registry entry: https://registry.modelcontextprotocol.io/servers/io.github.delorenj/mcp-server-trello
Demo badge: https://glama.ai/mcp/servers/klqkamy7wt

delorenj/mcp-server-trello

MCP Server Trello – AI‑friendly Trello bridge

관련