list_boardsLABSCO SUMMARY
Full board mechanics, and the token carries write access.
The tool set matches how a board is actually used — moving a card between lists, ticking a checklist item, putting a label on something — rather than stopping at read. That means the token you generate has read,write,account scope and the agent can delete cards, so use it on a board you can afford to have edited.
What it is
A TypeScript server over the Trello REST API, authenticated with your own key and token. It covers the objects a board is made of rather than one slice of them.
What you get
- Boards listed and inspected, with their members —
list_boards,get_board,get_board_members - Lists read, created, renamed and repositioned —
get_lists,create_list,update_list - Cards read, created, edited, moved between lists and deleted —
get_cards,create_card,update_card,move_card,delete_card - Members added to and removed from a card —
add_card_member,remove_card_member - Labels listed for a board, then applied to or removed from a card —
get_labels,add_card_label,remove_card_label - Checklists read and created on a card, with items added and marked complete —
get_card_checklists,create_checklist,add_checklist_item,update_checklist_item
Requirements
A Trello account with API access: take your key from trello.com/app-key and generate a token with read,write,account scope, then set TRELLO_API_KEY and TRELLO_TOKEN. Node.js 18+ and npm; npm install, npm run build, and point the client at dist/index.js. There is also a Docker path, including Docker Desktop's built-in MCP support from version 4.38 onward.
Setup effort
Build from source — clone the repository and build it, then point your client at the built dist/index.js
USE CASES
01
Triaging a backlog
Read the cards in a list, update what needs changing, and move the rest where they belong.
02
Turning a conversation into a card
Create the card with a description and due date, then put it in the right list with a label.
03
Setting up a workflow
Create the lists a board needs and reposition them into the order you want to work in.
04
Working a checklist
Add the items to a card and mark them complete as they get done, without opening Trello.
20 tools
Listed in project docs. Your client may show a different list.
get_boardget_board_membersget_listscreate_listupdate_listget_cardscreate_cardupdate_cardmove_carddelete_cardadd_card_memberremove_card_memberget_labelsadd_card_labelremove_card_labelget_card_checklistscreate_checklistadd_checklist_itemupdate_checklist_itemBEFORE YOU INSTALL
What to know first
Tools you get
20 tools named in the project's documentation.
Requires
- node on PATH
- Node.js 18+
- TRELLO_API_KEY in your environment
- TRELLO_TOKEN in your environment
INSTALLATION
Connect your client
Clone the repository and build it, then point your client at the built dist/index.js. This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/aepod/trello-mcp.git
cd trello-mcp
npm install
npm run build
node ./dist/index.jsMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"trello": {
"command": "node",
"args": [
"<YOUR_PATH_TO_TRELLO_MCP>/dist/index.js"
],
"env": {
"TRELLO_API_KEY": "<YOUR_TRELLO_API_KEY>",
"TRELLO_TOKEN": "<YOUR_TRELLO_TOKEN>"
}
}
}
}macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Cursor
CURSOR · JSON
{
"mcpServers": {
"trello": {
"command": "node",
"args": [
"<YOUR_PATH_TO_TRELLO_MCP>/dist/index.js"
],
"env": {
"TRELLO_API_KEY": "<YOUR_TRELLO_API_KEY>",
"TRELLO_TOKEN": "<YOUR_TRELLO_TOKEN>"
}
}
}
}.cursor/mcp.json
VS Code — devcontainer
VS CODE — DEVCONTAINER · JSON
{
"customizations": {
"vscode": {
"settings": {
"mcp.servers": {
"trello": {
"command": "node",
"args": [
"dist/index.js"
],
"env": {
"TRELLO_API_KEY": "${TRELLO_API_KEY}",
"TRELLO_TOKEN": "${TRELLO_TOKEN}"
}
}
}
}
}
},
"remoteEnv": {
"TRELLO_API_KEY": "${localEnv:TRELLO_API_KEY}",
"TRELLO_TOKEN": "${localEnv:TRELLO_TOKEN}"
}
}.devcontainer/devcontainer.json
