home / mcp / trello mcp server

Trello MCP Server

Provides Trello board, list, and card management via MCP with context loading and secure API authentication.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "abdwyer-trellomcp": {
      "command": "trello-mcp",
      "args": [],
      "env": {
        "TRELLO_API_KEY": "your_api_key_here",
        "TRELLO_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

You can run a Trello MCP Server to manage Trello boards, lists, and cards directly from your MCP-compatible client. It loads Trello data into context for analysis and lets you perform create, read, update, delete, and move operations via natural language commands.

How to use

Start by running the server in your environment, then connect to it from your MCP client. You can perform practical tasks like listing boards, creating boards or lists, managing cards, and moving cards between lists. You can also load Trello data into the LLM context for analysis, enabling conversational workflows that reflect the current state of your Trello workspace.

How to install

Prerequisites you need before installation:

Python 3.11 or higher
A Trello account
Trello API credentials (API key and token)

Install the MCP package and prepare the environment by following these steps.

# Clone or download this project
cd TrelloMCP

# Install using pip
pip install -e .

# Or using uvx (recommended for development)
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

Additional notes

Configuration and usage details are provided to help you run the server and connect your MCP client. The server uses environment variables to authenticate with Trello, and you can load specific Trello data into your context for analysis. Follow the environment variable instructions to keep credentials secure, and restart clients after configuration changes.

Environment variable guidance and example values to help you get started are shown in the following snippets.

# Environment variables example
TRELLO_API_KEY=your_api_key_here
TRELLO_API_TOKEN=your_api_token_here
```

```
# Run the server standalone
trello-mcp

Security and troubleshooting

Keep your Trello API credentials secure. Do not commit the .env file to version control. If you encounter credential or resource access issues, verify that your API key and token are correct and that you have access to the requested boards, lists, or cards.

If the server does not appear in your MCP client, ensure the command path is correct and that the client configuration is loaded. Restart the client after changes to the MCP configuration.

Available tools

list_boards

List all Trello boards available in your account.

get_board

Retrieve detailed information for a specific board by its ID.

create_board

Create a new Trello board with an optional description.

get_board_lists

Fetch all lists on a given board by board ID.

create_list

Create a new list on a specified board with an optional position.

archive_list

Archive (close) a Trello list by its ID.

list_cards

List all cards within a specific list.

get_card

Get details for a specific card by its ID.

create_card

Create a new card in a list with an optional description and position.

update_card

Update a card’s name, description, or list association.

delete_card

Delete a card by its ID.

move_card

Move a card to another list with an optional position.