Trello

You have a TypeScript MCP server for Trello that exposes Trello data—boards, lists, and cards—to AI assistants. It enables asynchronous, type-safe interactions with Trello, with clear error handling and environment-based configuration so you can securely connect to your Trello account and fetch or inspect data through MCP-enabled clients.

How to use

You use this MCP server by connecting an MCP client to it from your workflow. The server exposes tools that let you query your Trello data in a structured way, such as listing boards you own, retrieving lists from a specific board, fetching cards from a board or a list, and getting detailed information about a particular card. Your client can request these operations as part of its autonomous tasks, enabling you to build assistants that reason over Trello information and take actions accordingly.

Plan your queries around the core capabilities: first obtain your boards to understand the available projects, then drill into lists within a chosen board to locate the workflow stages, and finally fetch cards or card details to surface progress, assignees, due dates, and descriptions. The server handles authentication, rate limiting, and network errors so your client can focus on presenting and using the Trello data.

How to install

Prerequisites you need before installation:

• Node.js 18.x or higher
• npm or yarn
• Trello API credentials (API key and token)

Install dependencies and set up the server with these steps:

# Install dependencies
make install

# Build the project
make build

# Start the server
make start

# Clean build artifacts
make clean

# Run linter
make lint

Configuration and usage notes

Configure access to Trello by providing your API key and token in an environment file. Create a file named .env in the root with these values set to your Trello credentials.

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

Using with Cline (example MCP configuration)

If you use Cline to manage MCP servers, add a Trello MCP server configuration that points to the local build output.

{
  "mcpServers": {
    "trello_ts": {
      "command": "node",
      "args": ["/path/to/mcp-server-ts-trello/build/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_TOKEN": "your_token"
      }
    }
  }
}

Available tools

get_boards

Retrieves all Trello boards for the authenticated user.

get_lists

Fetches all lists from a specified board.

get_cards

Gets cards from a board or specific list.

get_card_details

Retrieves detailed information about a specific card.