Trello MCP Server by delorenj: Setup for Claude, Cursor and Other Apps

• Lists your Trello boards

  Returns every board your Trello token can reach, so the assistant can pick the right one.

  Try: “Which Trello boards do I have?”

  Network · list_boards

• Lists your workspaces

  Returns the workspaces you belong to. If you set an allowed-workspaces list, only those are shown.

  Try: “List my Trello workspaces.”

  Network · list_workspaces

• Lists the boards in one workspace

  Returns all boards inside a workspace you name.

  Try: “Show the boards in my Marketing workspace.”

  Network · list_boards_in_workspace

• Shows the board the assistant is working on

  Returns details about the board currently set as active.

  Try: “Which board are we working on right now?”

  Network · get_active_board_info

• Picks the board to work on

  Sets the active board so later calls do not need a board ID. The choice is saved in a small config file on your computer.

  Try: “Switch to the Product Roadmap board.”

  Write · set_active_board

• Picks the workspace to work in

  Sets the active workspace for later calls. The choice is saved in a small config file on your computer.

  Try: “Use the Design workspace from now on.”

  Write · set_active_workspace

• Creates a new board

  Creates a board, optionally inside a workspace you choose.

  Try: “Create a board called Q1 Launch in my Marketing workspace.”

  Write · create_board

• Lists the columns on a board

  Returns every list on the board.

  Try: “What lists are on this board?”

  Network · get_lists

• Adds a list to a board

  Creates a new list on the board.

  Try: “Add a list called Blocked.”

  Write · add_list_to_board

• Renames or changes a list

  Changes a list's name, archive state or watch state, or moves it to another board.

  Try: “Rename the Doing list to In progress.”

  Write · update_list

• Reorders a list

  Moves a list to a new spot on the board. Trello uses decimal positions, so a list goes between two others by averaging their positions.

  Try: “Move the Review list before Done.”

  Write · update_list_position

• Archives a list

  Sends a list to the archive so it no longer shows on the board.

  Try: “Archive the Old ideas list.”

  Write · archive_list

• Follows or unfollows a list

  Turns notifications for a list on or off.

  Try: “Watch the Bugs list.”

  Write · watch_list

• Lists the cards in a list

  Returns the cards in one list. Descriptions are shortened by default to keep the answer compact.

  Try: “Show the cards in the To do list.”

  Network · get_cards_by_list_id

• Shows everything on one card

  Returns the full details of a card.

  Try: “Open the card about the pricing page.”

  Network · get_card

• Lists cards assigned to you

  Returns every card assigned to the user the token belongs to.

  Try: “What cards are assigned to me?”

  Network · get_my_cards

• Shows recent board activity

  Returns recent actions on the board.

  Try: “What changed on this board today?”

  Network · get_recent_activity

• Shows the history of one card

  Returns the actions recorded on a card.

  Try: “Show the history of the launch checklist card.”

  Network · get_card_history

• Creates a card

  Creates a card in a list, with an optional description, due date, labels and members.

  Try: “Add a card "Fix signup bug" to the To do list, due Friday.”

  Write · add_card_to_list

• Creates many cards at once

  Creates several cards in a list in one request. They are created one after another, and rate limits are handled for you.

  Try: “Add these five tasks as cards in the Backlog list.”

  Write · add_cards_to_list

• Edits a card

  Changes a card's name, description, due date, labels or other details.

  Try: “Move the due date of the Pricing card to next Monday.”

  Write · update_card_details

• Moves a card to another list

  Moves a card to a different list, even on another board.

  Try: “Move the Fix signup bug card to Done.”

  Write · move_card

• Duplicates a card

  Copies a card to any list, even on another board. By default it copies checklists, attachments, comments and labels too.

  Try: “Copy the onboarding template card to the New hires list.”

  Write · copy_card

• Archives a card

  Sends a card to the archive.

  Try: “Archive all the finished cards from last sprint.”

  Write · archive_card

• Follows or unfollows a card

  Turns notifications for a card on or off.

  Try: “Watch the release card.”

  Write · watch_card

• Assigns someone to a card

  Adds a board member to a card.

  Try: “Assign Dana to the signup bug card.”

  Write · assign_member_to_card

• Unassigns someone from a card

  Removes a member from a card.

  Try: “Take Sam off the pricing card.”

  Delete · remove_member_from_card

• Lists the people on a board

  Returns the members of the board.

  Try: “Who is on this board?”

  Network · get_board_members

• Comments on a card

  Adds a comment to a card.

  Try: “Comment "Shipped in 2.4" on the release card.”

  Write · add_comment

• Edits a comment

  Replaces the text of an existing comment.

  Try: “Fix the typo in my last comment on the release card.”

  Write · update_comment

• Deletes a comment

  Deletes a comment from a card.

  Try: “Delete the outdated comment on the pricing card.”

  Delete · delete_comment

• Reads a card's comments

  Returns all the comments on a card.

  Try: “Show the comments on the launch card.”

  Network · get_card_comments

• Creates a checklist

  Creates a new checklist on a card.

  Try: “Add a Launch day checklist to this card.”

  Write · create_checklist

• Reads a checklist's items

  Returns all items in a checklist, found by its name.

  Try: “What is in the QA checklist?”

  Network · get_checklist_items

• Reads a checklist with progress

  Returns a whole checklist with its items and the percentage done.

  Try: “How far along is the Launch checklist?”

  Network · get_checklist_by_name

• Reads the Acceptance Criteria checklist

  Returns the items in the checklist named Acceptance Criteria.

  Try: “Show the acceptance criteria on this card.”

  Network · get_acceptance_criteria

• Searches checklist items

  Finds checklist items whose text contains the words you give.

  Try: “Find checklist items that mention "deploy".”

  Network · find_checklist_items_by_description

• Adds a checklist item

  Adds an item to a checklist.

  Try: “Add "Update the docs" to the Launch checklist.”

  Write · add_checklist_item

• Edits a checklist item

  Changes an item's name, done state, position, due date, reminder or assigned member.

  Try: “Tick off "Update the docs".”

  Write · update_checklist_item

• Deletes a checklist item

  Deletes an item from a card's checklist.

  Try: “Remove the "Old step" item from the checklist.”

  Delete · delete_checklist_item

• Copies a checklist to another card

  Copies a checklist with all its items from one card to another, even across boards.

  Try: “Copy the QA checklist to the new release card.”

  Write · copy_checklist

• Lists a board's labels

  Returns the labels defined on a board.

  Try: “What labels does this board have?”

  Network · get_board_labels

• Creates a label

  Creates a label on a board.

  Try: “Create a red label called Urgent.”

  Write · create_label

• Edits a label

  Changes an existing label's name or colour.

  Try: “Rename the Urgent label to P1.”

  Write · update_label

• Deletes a label

  Deletes a label from a board.

  Try: “Delete the unused Maybe label.”

  Delete · delete_label

• Lists a board's custom fields

  Returns the custom field definitions on a board, with IDs, names, types and dropdown options.

  Try: “What custom fields does this board use?”

  Network · get_board_custom_fields

• Sets a custom field on a card

  Sets or clears a custom field value on a card. Trello needs a Standard plan or higher for custom fields.

  Try: “Set the Priority field on this card to High.”

  Write · update_card_custom_field

• Attaches an image from a link

  Attaches an image to a card from a web address, or from a file on your computer when you give a file:// path.

  Try: “Attach this screenshot URL to the bug card.”

  Write · attach_image_to_card

• Attaches a file from a link

  Attaches any file to a card from a web address, or uploads a file from your computer when you give a file:// path.

  Try: “Attach the spec PDF from this link to the card.”

  Write · attach_file_to_card

• Attaches uploaded data

  Attaches an image, markdown, PDF, text or other content to a card from base64 data or a data URL.

  Try: “Attach these meeting notes as a markdown file on the card.”

  Write · attach_data_to_card

• Attaches an uploaded image

  Attaches an image to a card from base64 data or a data URL. It assumes PNG when no type is given.

  Try: “Attach this screenshot to the bug card.”

  Write · attach_image_data_to_card

• Downloads a card attachment

  Fetches an attachment from a card and returns it as base64 data.

  Try: “Download the spec attached to the launch card.”

  Network · download_attachment

• Used by the assistant behind the scenes

  Quick health check

  Returns a quick health status of the server and its connection to Trello.

  Try: “Is the Trello connection healthy?”

  Network · get_health

• Detailed health check

  Runs a fuller diagnostic across the server's parts.

  Try: “Run a detailed Trello health check.”

  Network · get_health_detailed

• Checks boards, lists and cards for consistency

  Verifies that boards, lists, cards and checklists agree with each other.

  Try: “Check the board data for inconsistencies.”

  Network · get_health_metadata

• Shows performance numbers

  Returns performance metrics for the server.

  Try: “Show Trello server performance metrics.”

  Network · get_health_performance

• Tries to fix issues the health check finds

  Runs the server's automatic repair when the health check reports repairable issues.

  Try: “Try to repair the Trello server issues.”

  Write · perform_system_repair

Watch out for

• It can delete comments, checklist items and labels

  delete_comment, delete_checklist_item and delete_label remove data from Trello, and remove_member_from_card unassigns people. There is no read-only switch, so only connect it to boards you can afford to change. github.com

• It can reach every workspace your token can

  By default all your workspaces are available. Set TRELLO_ALLOWED_WORKSPACES to a list of workspace IDs to limit it. github.com

• It can upload files from your computer to Trello

  attach_file_to_card and attach_image_to_card accept a file:// path, read that local file and upload it to the card. An assistant told to attach a private file will send it to Trello, so review what it is asked to attach. github.com

• It saves your active board to a file

  set_active_board and set_active_workspace write the chosen IDs to ~/.trello-mcp/config.json on your computer. github.com

Security advisories