# Trello MCP > Trello MCP Server connects your organization's Trello account to any AI agent. You can manage projects using natural conversation: list entire boards, read card details, move tasks between lists, or update member profiles—all without opening a browser tab. It gives your agent full control over your Kanban workflows. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** kanban, task-tracking, agile-management, workflow-automation, board-management, team-collaboration ## Description You're connecting your entire Trello workspace directly to your agent. You manage projects by talking to it; you don't gotta open a browser tab or click around. Your AI client gets full control over every single Kanban workflow in your account. **Getting the Lay of the Land** You can start by seeing everything that exists. Tell your agent to list all boards under your account, and it spits out the names of every active workspace. If you're focused on one board, you can pull up its full details using `get_board`. Once you know which board you want, you can ask for a rundown of every single column—the lists—it has sitting there with `list_lists`. **Reading Everything You Need to Know** Need to know what's going on inside? You can use `get_card` to pull all the metadata and current status details for any specific card ID you give it. That includes checking who's assigned, when something's due, the full description text, and the exact metrics of its status. If you want a list of everything in one spot, your agent will retrieve every single card within a specified list using `list_cards`. To see who’s on the team for a board, it displays the full roster through `list_members`, pulling up all associated people and their profile information. **Changing Things and Moving Tasks** Your agent handles the heavy lifting. You can create new tasks instantly with `create_card` if you just need a fresh item in the system. If an existing card needs tweaking, it modifies specific details using `update_card`. This means changing its status, updating the description, or fixing the assignee—all from a simple prompt. Moving stuff between lists is easy: your agent treats a task move like an update, repositioning cards for you across different columns. Remember that if you're done with a card and it needs to disappear, you can use `delete_card` to permanently remove it. **Managing Your Profile** To make sure the system knows who’s running everything, your agent uses `get_me`. This function returns the profile and credentials of the connected Trello user account. You're always in charge of what gets done on these boards. ## Tools ### add_checklist You can then add check items to it via the Trello UI. Add a new checklist to a Trello card ### add_comment Comments appear in the card activity feed and notify watchers. Add a comment to a Trello card ### add_label_to_card Use list_labels to get available label IDs for the board. Add a label to a Trello card ### create_card Creates a new Trello card in your workspace. ### delete_card Permanently removes a Trello card (use updating to archive instead). ### get_board Retrieves specific details for a single Trello board. ### get_card Fetches all metadata and current status details for one specific card ID. ### get_me Returns the profile and credentials of the connected Trello user account. ### list_board_cards Useful for getting a complete board overview. List all cards across all lists in a Trello board ### list_boards Lists all boards available under your Trello account. ### list_cards Retrieves a list of cards found within a specified Trello list (column). ### list_labels Use label IDs with add_label_to_card. List all labels for a Trello board ### list_lists Lists all columns/lists present on a given board. ### list_members Displays the full roster of people associated with a Trello board. ### search_cards Returns matching cards with board and list context. Search for Trello cards by keyword ### update_card Modifies specific details on an existing card, like its status or description. ## 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 ### List Board Structures Retrieves a list of all active boards and lists (columns) within any specified Trello workspace. ### Fetch Card Metadata Pulls complete details for a single card, including assignee, due date, description text, and status metrics. ### Adjust Tasks in Flow Creates new cards on demand or updates existing ones, allowing you to move tasks between different lists. ### View Team Roster Lists all members associated with a specific Trello board and retrieves their profile information. ### Search Across Boards Queries for cards by ID or searches across an entire board's contents. ## Use Cases ### The Sprint Retrospective Audit A PM needs to know if any tasks stalled last week. They ask their agent to run `list_cards` on the 'Testing' list and then filter those cards by due dates older than 3 days. The agent runs the tools, filters the results, and reports back only the overdue items. ### Quick Project Context Check An engineer is jumping into a project after two weeks away. Instead of opening Trello, they ask their agent to run `get_board` for the main board ID. The agent sends back the overall structure and key stakeholders instantly. ### Team Onboarding Setup An Ops Manager adds a new team member to a client workspace. They use `list_members` on the specific project board to confirm the existing roster, then use `update_card` to assign the new user as an owner on key initial tasks. ### Cleaning Up Stale Boards Someone needs to archive old client work. They ask their agent to run `list_boards`, identify the outdated board, and then use `delete_card` or `update_card` on all relevant cards to move them into an 'Archived' list. ## Benefits - Stop clicking through tabs to check status. Use `get_card` to pull assignment details, due dates, and descriptions instantly—all from your chat window. - Automate board setup. Need a new task? Use `create_card` to drop it onto the right list immediately, skipping manual navigation entirely. - Get a full picture of the project scope by using `list_boards` first, then `list_lists`, giving you an architectural map of your entire workflow. - Know who owns what. Run `list_members` and `get_me` to confirm team roles or check out specific user profiles on the board. - Move tasks faster than a human can click. Use `update_card` to change status, assignees, or move cards across columns with one simple command. ## How It Works The bottom line is: you talk project management commands to your AI client, and it handles the API interactions with Trello for you. 1. Subscribe to the Trello server and provide your API credentials. Your agent uses this connection to authenticate with your workspace. 2. Tell your AI client what you need—for example, 'List all boards for Project Alpha' or 'Update card ABC to status Done.' 3. The agent executes the necessary tool calls (like `list_boards` or `update_card`) and returns the real-time data directly in your chat interface. ## Frequently Asked Questions **How do I list all my Trello boards using the Trello MCP Server?** Run the `list_boards` tool. This instantly shows you every board available under your connected account, letting you know exactly what projects are active. **What is the difference between `list_cards` and `get_card` in Trello MCP Server?** `list_cards` gets a list of card titles/IDs from an entire column. Use `get_card` when you need deep details—like the full description, who is assigned, or the due date—for one specific card. **Can I change a task's status using Trello MCP Server?** Yes. Use the `update_card` tool to modify an existing card. You can change its assignee, update its description, or move it across lists by updating its metadata. **Does the Trello MCP Server help me find team members?** The `list_members` tool reads all profiles attached to a board. It's useful for knowing who is currently responsible for which project area. **How do I authenticate my account to use tools like `create_card`?** You connect your Trello organizational account by providing an API Key and a Token. The server uses these credentials to authorize every call, ensuring you only manage boards tied to your workspace. **What kind of data does the `get_board` tool return?** The `get_board` tool fetches comprehensive board metadata beyond just listing it. You get details like the board's unique ID, overall description, and member list, giving you a full context view. **Can I safely use the `delete_card` tool?** Be careful with hard deletions; we recommend using `update_card` instead. That tool lets you mark cards as closed, which acts like an archive and keeps your data intact for later review. **How do I check my own user details using the `get_me` function?** The `get_me` function retrieves current Trello user information. This lets you verify underlying credentials and profile metrics associated with the account connected to the MCP Server. **Can my AI automatically gather details of a specific card by its ID?** Yes! Use the `get_card` tool with exactly the Card ID. Your agent will respond with complete metadata, assignee fields, standard labels, and precise notes within seconds. **How do I move a card from 'To Do' to 'Done' seamlessly?** Simply ask the agent to run the `move_card` command. Providing the Card ID and the destination List ID (often found with `list_lists` first). It will transition your task across phases transparently. **Does the integration allow completely destructive operations like deleting my entire board?** No. The agent is limited to safe mutations related to Cards—creating, updating, and removing cards. It does not contain tools to delete large configurations like Boards or Columns, protecting your company’s structure.