trello-mcp-server

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

제공 도구

Related MCP server: Trello MCP Server

1. Trello API Key / Token 발급

1. https://trello.com/app-key 접속 (Trello 로그인 필요)

2. 상단의 API Key를 복사 → TRELLO_API_KEY

3. 같은 페이지의 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의 공개 REST API 문서를 참고해 직접 작성한 것이라 라이선스/저작권 문제는 없습니다. package.json의 라이선스는 원하는 대로(MIT 등) 바꿔도 됩니다.

• Trello/Atlassian 브랜드명을 프로젝트명에 쓰는 것 자체는 일반적으로 문제되지 않지만(수많은 오픈소스 커넥터가 이렇게 하고 있음), 로고 사용이나 "공식 Trello 제품"으로 오인될 수 있는 표현은 피하는 게 안전합니다.

참고

• Trello REST API 문서: https://developer.atlassian.com/cloud/trello/rest/

• Rate limit: 사용자 토큰 기준 10초당 100회, 앱 API 키 기준 10초당 300회 (초과 시 429 응답)