Claude Trello

You can run a specialized MCP server that exposes Trello board interactions as safe, typed actions. This makes it easy to perform common Trello tasks—like listing cards, adding or updating cards, and retrieving activity—through an MCP client while handling authentication, input validation, and rate limiting automatically.

How to use

You interact with the Trello MCP server through an MCP client. Use the client to call endpoints that correspond to Trello actions such as listing cards in a list, creating a new card, updating a card, or archiving items. Each action is exposed as a typed tool with clear parameters, and the server enforces input validation and handles Trello API rate limits for you. When you call a tool, you’ll supply the required arguments (like IDs and names), and you’ll receive structured results or clear error messages if something goes wrong.

How to install

Prerequisites you need before installing:
- Node.js 16 or higher
- npm or yarn

Follow these steps to install and prepare the MCP Trello server integration on your machine:

# Clone the project repository
git clone https://github.com/hrs-asano/claude-mcp-trello.git
cd claude-mcp-trello

# Install dependencies
npm install

# Build the project
npm run build

Additional configuration and start details

If you are integrating with Claude Desktop or a local MCP runner, you’ll run the server as a local process and provide the necessary environment variables. The following configuration shows how to launch the server locally with Node and point to the built entry file.

{
  "mcpServers": {
    "trello": {
      "command": "{YOUR_NODE_PATH}",
      "args": [
        "{YOUR_PATH}/claude-mcp-trello/build/index.js"
      ],
      "env": {
        "TRELLO_API_KEY": "{YOUR_KEY}",
        "TRELLO_TOKEN": "{YOUR_TOKEN}",
        "TRELLO_BOARD_ID": "{YOUR_BOARD_ID}"
      }
    }
  }
}

Available tools

trello_get_cards_by_list

Retrieves the cards contained in a specific Trello list by its ID. Requires the listId argument and returns the matching cards.

trello_get_lists

Fetches all lists on the board. No arguments required.

trello_get_recent_activity

Returns the most recent activity on the board. You can specify a limit to control how many activities are returned (default is 10).

trello_add_card

Adds a new card to a specified list. You provide the listId, card name, and optional description, due date, and label IDs.

trello_update_card

Updates an existing card with optional new name, description, due date, and labels using the cardId.

trello_archive_card

Archives (closes) a specified card by its cardId.

trello_add_list

Creates a new list on the board with the given name.

trello_archive_list

Archives (closes) a specified list by its listId.

trello_get_my_cards

Retrieves all cards related to the authenticated user.

trello_search_all_boards

Performs a cross-board search across all boards in the workspace (organization) based on a query and optional limit.