home / mcp / trello mcp server

Trello MCP Server

Provides Trello integration via MCP to manage boards, lists, and cards through Claude with Nango authentication.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ampcome-mcps-trello-mcp": {
      "command": "uvx",
      "args": [
        "git+https://github.com/ampcome-mcps/trello-mcp.git"
      ],
      "env": {
        "DEBUG": "false",
        "NANGO_BASE_URL": "https://api.nango.dev",
        "NANGO_SECRET_KEY": "your_nango_secret_key_here",
        "TRELLO_CLIENT_ID": "your_trello_api_key_here",
        "NANGO_CONNECTION_ID": "your_user_connection_id",
        "NANGO_INTEGRATION_ID": "trello"
      }
    }
  }
}

This MCP server enables Claude to interact with your Trello boards, lists, cards, and more through natural language commands, using secure Nango authentication to connect Trello with Claude. It provides real-time create/read/update/delete operations, search, and robust error handling so you can manage Trello content directly from conversational prompts.

How to use

You connect Claude to Trello through the MCP server described here. After configuring the environment and starting the server, you can ask Claude to show boards, create new boards, add lists or cards, move cards between lists, add comments or attachments, and search across Trello content. Use natural language when interacting with Claude, for example: “Show me my Trello boards,” “Create a board named Project Plan,” or “Move the card ‘Bug Fix’ to the ‘Done’ list.” You can also perform admin tasks like archiving lists or updating board details. If you encounter any errors, Claude will surface actionable messages and reference the underlying Trello permissions and authentication status. Ensure your Nango integration is active and your Trello API key is valid for a smooth experience.

Important capabilities include: querying boards, lists, and cards; creating, updating, and deleting boards, lists, and cards; adding comments and attachments to cards; and performing cross-entity searches. You’ll receive quick feedback on successful operations and clear errors if a request fails due to permissions, authentication, or missing data.

How to install

Prerequisites you need before installing: Python 3.13 or newer, an active Nango account with Trello configured, and Trello API credentials (Client ID). You will also run the MCP server locally via UV (the recommended runtime) or install via pip for development.

Step-by-step setup and run flow:

1) Clone the MCP project and enter its directory.

2) Install dependencies using UV or pip.

Configuration and runtime

{
  "mcpServers": {
    "trello": {
      "command": "uvx",
      "args": ["git+https://github.com/ampcome-mcps/trello-mcp.git"],
      "env": {
        "NANGO_BASE_URL": "https://api.nango.dev",
        "NANGO_SECRET_KEY": "your_nango_secret_key_here",
        "NANGO_CONNECTION_ID": "your_user_connection_id",
        "NANGO_INTEGRATION_ID": "trello",
        "TRELLO_CLIENT_ID": "your_trello_api_key_here"
      }
    }
  }
}

Place this configuration in Claude Desktop’s MCP server section. The server uses UV to fetch and run the MCP package directly from the public repository. Ensure your environment variables are set in both the configuration and your local environment for consistency.

Environment and credentials

You manage credentials through Nango and Trello. The following environment variables are used by the Trello MCP server configuration you’ll run locally:

- NANGO_BASE_URL: base URL for Nango API - NANGO_SECRET_KEY: secret key for your Nango integration - NANGO_CONNECTION_ID: connection identifier for your Trello integration - NANGO_INTEGRATION_ID: Trello integration identifier in Nango - TRELLO_CLIENT_ID: Trello API key - DEBUG: enable or disable verbose debugging (optional)

Testing the installation

To start the server directly for testing, run the following command in your terminal from the Trello MCP project directory:

uv run trello-mcp

Examples of usage in Claude

Once configured, you can issue natural language requests to Claude such as: “Show me all my Trello boards,” “Create a new board called 'Project Planning',” “What lists are on my 'Work Tasks' board?”, and “Add a card called 'Review PR' to the 'To Do' list.” You can also perform advanced actions like moving a card between lists, adding comments, attaching files, and performing global searches for cards or boards.

Troubleshooting

If you run into issues, verify the following: the environment variables are correctly configured; your Nango integration is active and connected to Trello; your Trello API key is valid; the MCP server is reachable from your Claude client; and you have the necessary Trello permissions for the requested operations. Restart Claude Desktop after configuration changes and ensure the path to the MCP server in the Claude config is correct.

Available tools

trello_get_my_boards

Fetch all boards owned by the connected Trello user.

trello_get_board

Retrieve details for a specific Trello board.

trello_create_board

Create a new Trello board with a given name and optional settings.

trello_update_board

Update properties of an existing Trello board.

trello_delete_board

Delete a Trello board.

trello_get_board_lists

Get all lists on a specified board.

trello_get_board_cards

List all cards on a specified board.

trello_get_board_members

Get members of a board.

trello_create_list

Create a new list on a board.

trello_update_list

Update details of an existing list.

trello_archive_list

Archive a Trello list.

trello_get_list_cards

Get cards in a specific list.

trello_create_card

Create a new card in a list.

trello_get_card

Retrieve details of a card.

trello_update_card

Update card properties or move it between lists.

trello_delete_card

Delete a card.

trello_add_comment_to_card

Add a comment to a card.

trello_add_attachment_to_card

Attach a file to a card.

trello_search

Search across boards, cards, and members.