Trello

This MCP server bridges Claude with Trello using Nango authentication, enabling natural language interactions with Trello boards, lists, cards, and more. It supports complete Trello API coverage, secure OAuth via Nango, real-time operations, search capabilities, and robust error handling to keep credentials fresh.

How to use

Install and run the Trello MCP Server local runtime, then connect it to Claude so you can manage Trello content through natural language. You will use a local MCP endpoint that Claude can query via your configured MCP client. Once configured, you can ask Claude to show boards, create lists, move cards, add comments, and search Trello data. The tooling supports all standard Trello operations such as boards, lists, cards, and search across boards and members.

How to install

Prerequisites you need before starting:

• Python 3.13+ installed on your system
• A Nango account with Trello integration configured
• Trello API credentials (Client ID)

Step by step commands you will run to set up and start the MCP server locally:

# Step 1: Clone the repository
# Replace with your actual repo URL
# git clone <your-repo-url>
# cd trello-mcp

# Step 2: Install dependencies (recommended via UV)
uv sync

# If you prefer Python packaging locally
# pip install -e .

# Step 3: Start the MCP server for testing
uv run trello-mcp

Configuration and usage notes

Configure environment variables to connect Claude to Trello via Nango. Create a .env file in the project root and populate the required values.

# Nango Configuration
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 Configuration
TRELLO_CLIENT_ID=your_trello_api_key_here

# Optional: Enable debug mode
DEBUG=false

Claude Desktop configuration

Add the MCP server configuration to your Claude Desktop settings so Claude can communicate with the Trello MCP server.

{
  "mcpServers": {
    "trello": {
      "command": "uvx",
      "args": ["git+https://github.com/Shameerpc5029/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"
      }
    }
  }
}

Testing the installation

Verify the server starts and Claude can load the Trello tools. You should see the Trello tools in the Claude tool palette after restarting the client.

# Test the server directly
uv run trello-mcp

# Restart Claude Desktop after configuration

Usage examples

Use Claude to perform common Trello tasks through natural language. Examples include listing boards, creating a board, and moving cards.

Basic operations you can try with Claude after configuration:

Show me all Trello boards
Create a new board called 'Project Planning'
What lists are on my 'Work Tasks' board
Add a card called 'Review PR' to the 'To Do' list

Security and troubleshooting

Ensure only trusted clients can access the MCP server. Keep your Nango secrets and Trello API keys secure. If you run into authentication issues, verify your Nango integration and Trello API key, and confirm the Nango connection is active.

Common issues include missing environment variables, authentication failures, the MCP server not appearing in Claude, or tool execution errors. Check that the environment is set correctly, restart Claude Desktop after changes, and ensure network access to Nango and Trello.

Notes

This example uses a local runtime approach with UV and a git-based MCP server URL. Adjust paths and keys to your environment. The server supports full Trello API coverage, including boards, lists, cards, comments, attachments, and search.

Available tools

trello_get_my_boards

Fetch all boards owned by the authenticated Trello user, returning board metadata such as id, name, and url.

trello_get_board

Retrieve details for a specific board by its ID or name, including lists and cards when requested.

trello_create_board

Create a new Trello board with a specified name and optional description, then return the new board's details.

trello_update_board

Update board properties such as name, description, or preferences.

trello_delete_board

Delete a Trello board by its ID.

trello_get_board_lists

List all lists on a given board, including list IDs and names.

trello_get_board_cards

List all cards on a specific board, with details for each card.

trello_get_board_members

Return members associated with a board.

trello_create_list

Create a new list on a specified board with a given name.

trello_update_list

Modify list properties such as name or status.

trello_archive_list

Archive a list to hide it from active views.

trello_get_list_cards

Get all cards within a specific list.

trello_create_card

Create a new card in a specified list with a title and optional details.

trello_get_card

Fetch detailed information for a single card.

trello_update_card

Update card attributes, including moving the card to another list.

trello_delete_card

Delete a card by its ID.

trello_add_comment_to_card

Add a comment to a card with specified text.

trello_add_attachment_to_card

Attach a file or URL to a card.

trello_search

Search boards, cards, and members across Trello using a query.