io.github.Jimdrews/fastmcp-trello

Official

by Jimdrews · Python

Trello MCP Server

Manage Trello boards, lists, and cards from any MCP-compatible AI assistant

Manage Trello boards, lists, and cards through MCP-compatible AI assistants.

Topics

agentsaiai-toolsautomationclaudeclaude-codecopilotcursorfastmcpllmmcpmcp-servermodel-context-protocolproject-managementpythontask-managementtrellotrello-api

README.md4 KBView on GitHub

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:

Go to the Trello Power-Ups admin page
Create a new Power-Up (any name/workspace will do)
Generate a new API key
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.):

json

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

Or run standalone:

bash

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

bash

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

Install

Configuration

Environment variables

TRELLO_API_KEYrequiredsecret

Trello API key from https://trello.com/power-ups/admin

TRELLO_TOKENrequiredsecret

Trello API token

claude_desktop_config.json

{
  "mcpServers": {
    "fastmcp-trello": {
      "command": "uvx",
      "args": [
        "fastmcp-trello"
      ],
      "env": {
        "TRELLO_API_KEY": "<YOUR_TRELLO_API_KEY>",
        "TRELLO_TOKEN": "<YOUR_TRELLO_TOKEN>"
      }
    }
  }
}