Skip to main content
Glama

PyPI Python CI License: MIT

A Trello MCP server — manage boards, cards, and lists from any AI assistant that supports the Model Context Protocol. MCP is an open standard that lets AI assistants like Claude, Cursor, and Copilot interact with external tools and services.

Trello MCP Tools

Tool

Description

get_boards

List all boards accessible to you

get_board

Get a board's details including its lists

get_lists

Get all open lists on a board

create_board

Create a new board

update_board

Update a board's name or description

close_board

Close (archive) a board

get_cards

Get all cards in a list

get_card

Get full details for a card including comments

create_card

Create a new card on a list

update_card

Update a card's fields or move it to a different list

archive_card

Archive (close) a card

get_labels

Get all labels defined on a board

create_label

Create a new label on a board

delete_label

Delete a label from a board

add_label_to_card

Add a label to a card

remove_label_from_card

Remove a label from a card

create_list

Create a new list on a board

update_list

Rename a list

archive_list

Archive (close) a list

move_list

Move a list to a new position

get_attachments

Get all attachments on a card

add_attachment

Add a URL attachment to a card

delete_attachment

Delete an attachment from a card

add_comment

Add a comment to a card

search_cards

Search for cards across boards, optionally scoped to a specific board

Related MCP server: Trello MCP Server

Prerequisites

You need a Trello API key and token:

  1. Go to the Trello Power-Ups admin page

  2. Create a new Power-Up (any name/workspace will do)

  3. Generate a new API key

  4. From the API key page, click the Token link to generate a token

Installation

Add the following to your MCP client configuration (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "trello": {
      "command": "uvx",
      "args": ["fastmcp-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

Or run standalone:

TRELLO_API_KEY=your-api-key TRELLO_TOKEN=your-token uvx fastmcp-trello

Usage

Once installed in your MCP client, you can ask your AI assistant things like:

"Show me all my Trello boards"

"Create a card called 'Fix login bug' in the To Do list on my Project board"

Configuration

Variable

Required

Description

TRELLO_API_KEY

Yes

Your Trello API key

TRELLO_TOKEN

Yes

Your Trello authentication token

Development

git clone https://github.com/Jimdrews/fastmcp-trello.git
cd fastmcp-trello
uv sync --group dev
uv run pytest

See CONTRIBUTING.md for more details.

License

MIT

Available Tools

25 tools
add_attachmentA

Add a URL attachment to a card. Only URLs are supported (no file uploads).

Inputs: url (required), card_id (required), name. Returns: result

add_commentB

Add a comment to a card.

Inputs: text (required), card_id (required). Returns: result

add_label_to_cardC

Add a label to a card.

Inputs: card_id (required), label_id (required). Returns: result

archive_cardB

Archive (close) a card.

Inputs: card_id (required). Returns: result

archive_listB

Archive (close) a list.

Inputs: list_id (required). Returns: result

close_boardA

Close (archive) a board. This does not permanently delete it.

Inputs: board_id (required). Returns: result

create_boardA

Create a new board. Set default_lists=false for a blank board.

Inputs: name (required), description, default_lists. Returns: result

create_cardA

Create a new card on a list.

Set position to "top", "bottom", or a positive float to control placement.

Inputs: name (required), list_id (required), due, position, +1 more. Returns: result

create_labelB

Create a new label on a board.

Inputs: name (required), board_id (required), color. Returns: result

create_listB

Create a new list on a board. Position can be 'top', 'bottom', or a number.

Inputs: name (required), board_id (required), position. Returns: result

delete_attachmentB

Delete an attachment from a card.

Inputs: card_id (required), attachment_id (required). Returns: result

delete_labelC

Delete a label from a board.

Inputs: label_id (required). Returns: result

get_attachmentsB

Get all attachments on a card.

Inputs: card_id (required). Returns: result

get_boardB

Get a board's details including its lists.

Inputs: board_id (required). Returns: result

get_boardsA

List all boards accessible to you.

Inputs: no named parameters. Returns: result

get_cardA

Get full details for a card including comments.

Inputs: card_id (required). Returns: result

get_cardsB

Get all cards in a list.

Inputs: list_id (required). Returns: result

get_labelsB

Get all labels defined on a board.

Inputs: board_id (required). Returns: result

get_listsA

Get all open lists on a board.

Inputs: board_id (required). Returns: result

move_listA

Move a list to a new position. Use 'top', 'bottom', or a number.

Inputs: list_id (required), position (required). Returns: result

remove_label_from_cardB

Remove a label from a card.

Inputs: card_id (required), label_id (required). Returns: result

search_cardsA

Search for cards across boards. Optionally scope to a specific board.

Inputs: query (required), board_id. Returns: result

update_boardB

Update a board's name or description.

Inputs: board_id (required), name, description. Returns: result

update_cardA

Update a card's fields.

Set list_id to move the card to a different list. Set position to "top", "bottom", or a positive float to reorder within the list.

Inputs: card_id (required), due, name, list_id, +2 more. Returns: result

update_listC

Rename a list.

Inputs: name (required), list_id (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 25 tools

    Disambiguation5/5

    Every tool targets a specific resource and action (e.g., get_boards vs get_board vs get_cards), making them easy to distinguish. Even similar operations like archive_card and close_board are clearly separated by resource type.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with lowercase snake_case (e.g., create_board, update_card, add_attachment). No mixed conventions or vague verbs.

    Tool Count3/5

    With 25 tools, the set feels heavy, though the breadth of Trello resources (boards, lists, cards, labels, attachments, comments) provides some justification. It sits at the top of the borderline range.

    Completeness4/5

    The set provides solid CRUD coverage for boards, lists, cards, labels, and attachments, plus comments and search. Minor gaps include label updates, member assignment, and permanent deletion (only archiving is available), but these are not critical.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers