trello-mcp

An MCP server for the Trello REST API. Exposes ~36 curated tools for boards, lists, cards, checklists, labels, members, and search.

Requires Node.js 18.14.1 or newer.

Setup

1. Get a Trello API key and token:
   • API key: https://trello.com/app-key
   • Token: click the "Token" link on that page and authorize.
2. Add the MCP server configuration below to your client.

Configure your MCP client

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@trinknx/[email protected]"],
      "env": {
        "TRELLO_API_KEY": "your-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

Keep real credentials in your MCP client's runtime environment configuration. Never commit credentials or rely on checked-in configuration files. For local development, export credentials into the process environment before starting the server.

Environment variables

| Variable | Required | Purpose | |----------|----------|---------| | TRELLO_API_KEY | yes | Trello API key | | TRELLO_TOKEN | yes | Trello API token | | TRELLO_BOARD_ID | no | Default board id. When set, board tools (get_board, get_board_lists, get_board_cards, get_board_labels, get_board_members, create_list, create_label) use it when no board id is passed. | | TRELLO_LIST_ID | no | Default list id. When set, create_card uses it when no idList is passed. |

The defaults are optional — omit them and pass ids explicitly, or set them so the agent doesn't have to ask which board/list to use. An explicit id always wins over the env default; if neither is given, the tool returns a clear error.

Tools

Boards: list_my_boards, get_board, create_board, update_board, delete_board, get_board_lists, get_board_cards, get_board_labels, get_board_members.

Lists: create_list, get_list, update_list, archive_list, get_list_cards, archive_all_cards_in_list.

Cards: create_card, get_card, update_card (move via idList, archive via closed, set cover via idAttachmentCover), delete_card, add_comment, add_card_member, remove_card_member, add_label_to_card, remove_label_from_card, get_card_attachments, add_attachment (set setCover: true to make a publicly-fetchable image the card cover), delete_attachment.

Checklists: create_checklist, add_checklist_item, update_checklist_item, delete_checklist.

Labels/Members/Search: create_label, get_me, get_member, search, search_members.

Development

npm install      # install dependencies
npm test         # run unit tests
npm run build    # compile to dist/
npm start        # run the server (node dist/index.js)

License

MIT