playbooks

Home / MCP / Trello MCP Server

Trello MCP Server

Provides Trello data access via MCP tools for boards, lists, and cards with TypeScript.

typescript
1star
View on GitHub
Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
    "mcpServers": {
        "trello_mcp": {
            "command": "node",
            "args": [
                "/path/to/mcp-server-ts-trello/build/index.js"
            ],
            "env": {
                "TRELLO_API_KEY": "YOUR_API_KEY",
                "TRELLO_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

This MCP server lets your AI assistants interact with Trello by exposing Trello boards, lists, and cards through a type-safe TypeScript implementation. It enables asynchronous operations, robust error handling, and environment-based configuration for smooth, scalable integrations.

How to use

You connect this MCP server to an MCP client to perform Trello actions. Use it to list boards, fetch lists from a board, retrieve cards from a board or a specific list, and obtain detailed information about a card. Run the server locally or remotely and pass your Trello data requests through the MCP client, which will forward them to the Trello MCP server and return results.

How to install

Prerequisites: you need Node.js 18.x or higher, npm or yarn, and Trello API credentials.

Install dependencies and set up the project locally by following these steps:

# Install dependencies
make install

Additional setup and usage notes

Create a .env file in your project root to provide Trello credentials. Include these keys with your own values:

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

Build and start the MCP Trello server. You will typically build the TypeScript source and run the generated JavaScript entry point, supplying your Trello credentials via environment variables.

# Build the project
make build

# Start the server (example runtime approach)
node /path/to/mcp-server-ts-trello/build/index.js

If you want to integrate with a client configuration tool, you can reference the following example MCP startup configuration, which runs the local server and provides the necessary Trello credentials via environment variables.

{
  "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"
      }
    }
  }
}

Notes on usage patterns

- Use get_boards to list all boards you have access to. - Use get_lists with a board_id to fetch lists on that board. - Use get_cards with board_id and an optional list_id to retrieve cards from a board or a specific list. - Use get_card_details with a card_id to obtain full information about a single card.

Security and best practices

Keep Trello API credentials secure. Do not commit the .env file to version control. Rotate credentials as needed and restrict API key permissions to the minimum required for your integration.

Troubleshooting and tips

If you encounter authentication or rate limiting issues, verify that your TRELLO_API_KEY and TRELLO_TOKEN are valid and have the necessary Trello scopes. Ensure your environment variables are loaded by the runtime and that the build output path in your startup command matches your project structure.

Examples and tips for developers

The server exposes MCP tools for Trello interactions. As you integrate with clients, you can rely on the following tools: get_boards, get_lists, get_cards, and get_card_details to perform common Trello data retrieval tasks.

Available tools

get_boards

Retrieves all Trello boards accessible to the authenticated user.

get_lists

Fetches all lists from a specified board.

get_cards

Gets cards from a board or a specific list.

get_card_details

Retrieves detailed information about a specific card.