trello-mcp-server

Trello REST API를 감싸는 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Claude Code 등 MCP를 지원하는 클라이언트에 연결하면 채팅에서 Trello 보드/리스트/카드를 조회하고 생성·수정할 수 있습니다.

제공 도구

도구	설명
`trello_list_boards`	내 보드 목록 조회
`trello_get_board`	보드 상세 조회
`trello_list_lists`	보드 안의 리스트(컬럼) 조회
`trello_list_cards_in_list`	특정 리스트의 카드 조회
`trello_list_cards_in_board`	보드 전체 카드 조회
`trello_get_card`	카드 상세 조회
`trello_search`	카드/보드 키워드 검색
`trello_create_card`	카드 생성
`trello_update_card`	카드 수정(제목/설명/마감일/리스트 이동/보관)
`trello_add_comment`	카드에 댓글 추가
`trello_create_list`	보드에 새 리스트 생성

1. Trello API Key / Token 발급

https://trello.com/app-key 접속 (Trello 로그인 필요)
상단의 API Key를 복사 → TRELLO_API_KEY
같은 페이지의 Token 링크를 클릭해 권한 위임 후 발급되는 토큰을 복사 → TRELLO_TOKEN

이 두 값은 계정 접근 권한을 가진 비밀값입니다. 코드에 직접 적지 말고 환경 변수로만 전달하세요.

2. 설치

git clone <이 저장소 URL>
cd trello-mcp-server
npm install

3. Claude Desktop / Claude Code에 등록

claude_desktop_config.json (또는 Claude Code의 MCP 설정)에 아래와 같이 추가합니다.

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/절대/경로/trello-mcp-server/src/index.js"],
      "env": {
        "TRELLO_API_KEY": "여기에_본인_API_KEY",
        "TRELLO_TOKEN": "여기에_본인_TOKEN"
      }
    }
  }
}

설정 후 Claude를 재시작하면 trello_list_boards 등의 도구를 채팅에서 바로 호출할 수 있습니다.

GitHub에 공개할 때 주의할 점

API Key/Token을 절대 커밋하지 마세요. 이 저장소의 .gitignore는 .env 파일을 제외하도록 되어 있지만, claude_desktop_config.json처럼 개인 설정 파일을 실수로 함께 커밋하지 않도록 주의하세요.
커밋 히스토리에 한 번이라도 토큰이 올라갔다면 git 히스토리에서 지우는 것만으로는 부족합니다 — Trello 계정 설정에서 해당 토큰을 즉시 폐기(revoke)하고 재발급하세요.
Trello/Atlassian 브랜드명을 프로젝트명에 쓰는 것 자체는 일반적으로 문제되지 않지만(수많은 오픈소스 커넥터가 이렇게 하고 있음), 로고 사용이나 "공식 Trello 제품"으로 오인될 수 있는 표현은 피하는 게 안전합니다.

참고

Trello REST API 문서: https://developer.atlassian.com/cloud/trello/rest/
Rate limit: 사용자 토큰 기준 10초당 100회, 앱 API 키 기준 10초당 300회 (초과 시 429 응답)