MCP Trello

You can use this MCP Trello server to interact with Trello boards through a typed, rate-limited API. It exposes a set of tools to manage boards, lists, and cards, while handling input validation and errors for you.

How to use

You interact with Trello through an MCP client that connects to the MCP Trello server. Start by configuring the client to reach the server, then call the available tools to manage boards, lists, and cards. Use the tools to fetch boards, retrieve cards by list, add or update cards, move items between lists, archive items, and manage board activity. Tools can be invoked in a type-safe way from your AI host or client SDK, and responses will include structured results or informative errors when something goes wrong.

How to install

Prerequisites you need before installing: Node.js (with npm or pnpm) installed on your system. A modern terminal or command prompt. Internet access to fetch packages.

Choose one of the installation paths below. Follow the exact commands for your environment to install the MCP Trello server.

# Using Smithery to install MCP Trello for a specific client
npx -y @smithery/cli install @Hint-Services/mcp-trello --client claude
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cursor
npx -y @smithery/cli install @Hint-Services/mcp-trello --client windsurf
npx -y @smithery/cli install @Hint-Services/mcp-trello --client cline
npx -y @smithery/cli install @Hint-Services/mcp-trello --client typescript

# Manual installation (standalone server)
pnpm add mcp-trello

Configuration and environment

Configure your MCP settings to run the server. Provide the command to execute the MCP Trello server and the environment variables needed to connect to Trello.

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@Hint-Services/mcp-trello"],
      "env": {
        "trelloApiKey": "YOUR_API_KEY",
        "trelloToken": "YOUR_TOKEN",
        "trelloBoardId": "YOUR_BOARD_ID"
      }
    }
  }
}

Notes on usage

Some tools require a specific board ID to operate, while others can work with your account in a broader scope. If you omit the board ID initially, you can use tools that don’t require a board ID to discover your boards and IDs, then update your configuration with the correct 24-character board ID.

Additional guidance

If you need to run the server locally, start it using the configured command and ensure your Trello API key and token are valid. Monitor the server logs for rate-limiting messages and address any input validation errors reported by the MCP server. For best reliability, keep your Trello API key and token secure and rotate credentials as part of your security practices.

Available tools

getMyBoards

Retrieve all boards for the authenticated user to discover board IDs and names.

getCardsByList

Fetch all cards from a specific list on your board.

getMyCards

Fetch all cards assigned to the current user, without needing a specific board ID.

addCard

Add a new card to a specified list on the configured board.

updateCard

Update a card's details such as name, description, due dates, labels, and position.

moveCard

Move a card to a different list or to another board.

archiveCard

Archive a specific card, removing it from active boards.

changeCardMembers

Add or remove members from a card.

getLists

Retrieve all lists from the configured board (requires board ID).

addList

Add a new list to the board (requires board ID).

archiveList

Archive a list on the board.

getRecentActivity

Fetch recent activity on the board (requires board ID).