# Trello MCP > Trello MCP gives your AI agent full control over your agile workflows. List boards, inspect card details, search across entire projects, and move tasks between lists—all using natural conversation. Stop clicking through dozens of tabs; manage your Kanban flow directly from any compatible client. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** kanban, task-tracking, agile-management, workflow-automation, board-management, team-collaboration ## Description Need to track complex project flows but don't have time for the Trello UI? This MCP connects your organizational account so your AI agent handles all the heavy lifting. You can start by listing all active boards or fetching details about a specific board structure. From there, you can list every column (list) and check which cards live in them. Want to know who's assigned to 'Feature X'? Your agent pulls that member data immediately. Need to update something? The tool lets you create new cards on the fly, add labels, or even move tasks from 'To Do' straight into 'In Progress'. Because this MCP is hosted and managed by Vinkius, your AI client gets immediate access to all these project management operations without needing multiple integrations. It makes your agent act like a dedicated Scrum Master for every Kanban board you use. ## Tools ### add_checklist Adds a new checklist item list to an existing Trello card. ### add_comment Posts a visible comment into the activity feed of a specific Trello card. ### add_label_to_card Applies one or more defined labels to an existing Trello card. ### create_card Generates and adds a brand new, blank Trello card onto the board. ### delete_card Removes a Trello card; note that archiving is usually preferred over permanent deletion. ### get_board Retrieves the full structural details and metadata for a single, specific board. ### get_card Fetches all the detailed information associated with one unique Trello card ID. ### get_me Retrieves and displays the profile details of the currently connected Trello user account. ### list_board_cards Lists every card present across all columns within a designated board for an overall view. ### list_boards Retrieves a list of all Trello boards accessible to the connected user account. ### list_cards Retrieves all cards contained only within one specified list (column). ### list_labels Shows a list of available label options for a specific Trello board. ### list_lists Displays the names and IDs of the columns within a specific board's structure. ### list_members Lists all users who are members of the target Trello board. ### search_cards Searches across the entire board for cards matching a given keyword or phrase. ### update_card Modifies existing details on a Trello card, such as changing its description or assignee. ## Prompt Examples **Prompt:** ``` List all the boards under my Trello account right now. ``` **Response:** ``` I've retrieved your boards. You currently operate 'Development Sprints' (ID: 64fa8211), 'Content Marketing' (ID: 64ea9bc), and 'IT Tickets'. Which one should we dive into? ``` **Prompt:** ``` Can you check the cards currently inside the 'To Do' list ID 618ab221? ``` **Response:** ``` Running the extraction... I found 4 cards currently in 'To Do'. These include 'Update Auth Module' (ID: 63ab), 'Setup DB Indexes' (ID: 6511), and two others. Would you like to read the details for the Auth task? ``` **Prompt:** ``` Create a new board card called 'Verify Webhooks' with the description 'Check timeout limits under high load' on list 618ab221. ``` **Response:** ``` Task accomplished. 'Verify Webhooks' has been successfully created with an attached ID of 660f9a2bccd. Feel free to ask if you need to fetch its timeline or update the card further. ``` ## Capabilities ### Board and Project Discovery List available boards or retrieve the full details of any specific Trello board. ### Task Status Retrieval Get a complete overview by listing all cards across every list on a board, or searching for tasks using keywords. ### Deep Card Inspection Fetch detailed metadata for an individual card, including due dates, assignees, and full descriptions. ### Workflow Manipulation Create new tasks, update existing cards, or move them between lists using simple commands. ### Team Membership Management List all members associated with a board to check team roles and profile information. ## Use Cases ### The end-of-sprint status meeting prep A PM asks their agent to list all cards in the 'Testing' column that haven't been updated in the last two weeks. The agent runs `list_cards` and reports back a list of stale tasks, allowing the PM to flag them immediately. ### Client onboarding board setup An Ops Specialist needs to set up a new client workspace. They ask the agent to retrieve all active boards using `list_boards` and then use `get_board` on the primary board ID to confirm necessary lists exist. ### Hand-off task documentation An Engineer finishes a task and needs to document it for the next team member. They ask their agent to update the card using `update_card` with detailed notes and then add a comment via `add_comment` to notify the assignee. ### Project audit compliance check A manager needs proof of who worked on an old feature. They ask the agent to list all members using `list_members` and then fetch detailed card data for specific IDs using `get_card`, proving ownership. ## Benefits - You can pull a full status report by running `list_board_cards`, giving you an immediate, aggregated view of every task without navigating the UI. This saves minutes on any single project review. - Instead of opening and reading multiple tabs to find who's assigned to a specific item, your agent runs `list_members` or pulls assignee data directly from `get_card` details. - Want to move a card but forget which column it belongs in? You can use the MCP to update the task location and then add a comment explaining why you moved it. It's an atomic workflow change. - When a new feature is ready, you don't need to manually create a ticket; just ask your agent to `create_card` on the 'Testing' list, complete with necessary details. - If you need to find that one card from three months ago, use `search_cards`. It pulls results based on keywords across all boards and lists, drastically cutting down search time. ## How It Works The bottom line is you talk to your AI agent using natural language, and it translates that into structured Trello commands. 1. Subscribe to the Trello MCP and provide your API Key and Token credentials. 2. Connect this MCP to your preferred AI client (Cursor, Claude, etc.). 3. Ask your agent a question like, 'What tasks are currently waiting in the QA list?' and get instant data. ## Frequently Asked Questions **How do I list all the boards under my Trello account using Trello MCP?** You simply ask your agent to run `list_boards`. The agent returns a list of every board you have access to, allowing you to select which project data set you want to work with next. **Can I update the status of a card using Trello MCP?** Yes. You use `update_card` in conjunction with other tools. For example, you can move it and then add a label simultaneously to reflect its new state. **Does Trello MCP allow me to see who is on the board?** Absolutely. Run `list_members` to retrieve all credentials and profile details for everyone connected to that specific project board. **What if I want to create a new card with lots of detail using Trello MCP?** You use the `create_card` tool. You can provide the initial title, description, and even suggest labels when you make the request. **Is Trello MCP better than just looking at the Trello app?** It’s faster because it skips the UI entirely. Instead of navigating multiple views to compile a status report, your agent runs `list_board_cards` and gives you the clean data set immediately.