Trello MCP Server

A Model Context Protocol (MCP) server that provides seamless integration between Claude and Trello via Nango authentication. This server enables Claude to interact with your Trello boards, lists, cards, and more through natural language commands.

🚀 Features

• Complete Trello API Coverage: Manage boards, lists, cards, comments, and attachments
• Secure Authentication: Uses Nango for OAuth authentication with Trello
• Real-time Operations: Create, read, update, and delete Trello items instantly
• Search Functionality: Search across boards, cards, and members
• Error Handling: Robust error handling with automatic credential refresh

📋 Available Tools

Board Operations

• trello_get_my_boards - Get all your boards
• trello_get_board - Get specific board details
• trello_create_board - Create new boards
• trello_update_board - Update board information
• trello_delete_board - Delete boards
• trello_get_board_lists - Get all lists on a board
• trello_get_board_cards - Get all cards on a board
• trello_get_board_members - Get board members

List Operations

• trello_create_list - Create new lists
• trello_update_list - Update list details
• trello_archive_list - Archive lists
• trello_get_list_cards - Get cards in a specific list

Card Operations

• trello_create_card - Create new cards
• trello_get_card - Get card details
• trello_update_card - Update cards (including moving between lists)
• trello_delete_card - Delete cards
• trello_add_comment_to_card - Add comments to cards
• trello_add_attachment_to_card - Add attachments to cards

Search & Discovery

• trello_search - Search across Trello for boards, cards, members, etc.

🛠️ Installation

Prerequisites

1. Python 3.13+ installed on your system
2. Nango account with Trello integration configured
3. Trello API credentials (Client ID)

Step 1: Clone and Setup

git clone <your-repo-url>
cd trello-mcp

Step 2: Install Dependencies

Using UV (recommended):

uv sync

Or using pip:

pip install -e .

Step 3: Environment Configuration

Create a .env file in the project root:

# 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

Step 4: Configure Claude Desktop

Add the following configuration to your Claude Desktop config file:

Location of config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

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

🔧 Setup Guide

Getting Your Credentials

1. Nango Setup

1. Sign up at Nango.dev
2. Create a new integration for Trello
3. Configure OAuth settings
4. Get your NANGO_SECRET_KEY from the dashboard
5. Set up a connection and note the NANGO_CONNECTION_ID

2. Trello API Key

1. Go to Trello Developer Portal
2. Get your API Key (this becomes your TRELLO_CLIENT_ID)

Testing the Installation

1. Test the server directly:

   uv run trello-mcp
   

2. Check Claude Desktop:

   • Restart Claude Desktop
   • Look for the Trello tools in the tool palette
   • Try asking: "Show me my Trello boards"

💡 Usage Examples

Once configured, you can interact with Trello through Claude using natural language:

Basic Operations

• "Show me all my 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"

Advanced Operations

• "Move the card 'Bug Fix' from 'In Progress' to 'Done'"
• "Add a comment to the card about updating documentation"
• "Search for all cards containing 'urgent'"
• "Create a new list called 'Blocked' on my current project board"

Project Management

• "Set up a new project board with lists: Backlog, To Do, In Progress, Review, Done"
• "Show me all cards assigned to me across all boards"
• "Archive the completed sprint list"

🔍 Troubleshooting

Common Issues

1. "Missing required environment variables" error

   • Ensure all required variables are set in your .env file
   • Check that the config in Claude Desktop matches your environment

2. Authentication failures

   • Verify your Nango integration is properly configured
   • Check that your Trello API key is correct
   • Ensure the Nango connection is active

3. Server not appearing in Claude

   • Restart Claude Desktop after configuration changes
   • Check the file path in the Claude config is correct
   • Verify the uv command is available in your PATH

4. Tool execution fails

   • Check the server logs for detailed error messages
   • Verify your Trello permissions allow the requested operations

Debug Mode

Enable debug logging by setting DEBUG=true in your .env file for detailed operation logs.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

If you encounter any issues:

1. Check the troubleshooting section above
2. Review the MCP documentation
3. Check Nango documentation
4. Open an issue in this repository

🔗 Related Links

• Model Context Protocol
• Nango Documentation
• Trello API Documentation
• Claude Desktop