fastmcp-trello 0.5.0

A Trello MCP server built with FastMCP

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

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