fastmcp-trello 0.1.0

A Trello MCP server built with FastMCP

fastmcp-trello

A Trello MCP server — manage boards, cards, and lists from any AI assistant that supports the Model Context Protocol.

Available 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
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
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. Get your API key
3. From that page, generate a token

Installation

Claude Desktop

Add to your Claude Desktop configuration file (claude_desktop_config.json):

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

VS Code

Add to your VS Code MCP settings (.vscode/mcp.json):

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

Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json):

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

Standalone

# Run directly (no install needed)
uvx fastmcp-trello

# Or install globally
pip install fastmcp-trello
fastmcp-trello

# Use HTTP transport instead of stdio
fastmcp-trello --transport http

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