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 boardstrello_get_board- Get specific board detailstrello_create_board- Create new boardstrello_update_board- Update board informationtrello_delete_board- Delete boardstrello_get_board_lists- Get all lists on a boardtrello_get_board_cards- Get all cards on a boardtrello_get_board_members- Get board members
List Operations
trello_create_list- Create new liststrello_update_list- Update list detailstrello_archive_list- Archive liststrello_get_list_cards- Get cards in a specific list
Card Operations
trello_create_card- Create new cardstrello_get_card- Get card detailstrello_update_card- Update cards (including moving between lists)trello_delete_card- Delete cardstrello_add_comment_to_card- Add comments to cardstrello_add_attachment_to_card- Add attachments to cards
Search & Discovery
trello_search- Search across Trello for boards, cards, members, etc.
🛠️ Installation
Prerequisites
- Python 3.13+ installed on your system
- Nango account with Trello integration configured
- 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
- Sign up at Nango.dev
- Create a new integration for Trello
- Configure OAuth settings
- Get your
NANGO_SECRET_KEYfrom the dashboard - Set up a connection and note the
NANGO_CONNECTION_ID
2. Trello API Key
- Go to Trello Developer Portal
- Get your API Key (this becomes your
TRELLO_CLIENT_ID)
Testing the Installation
-
Test the server directly:
uv run trello-mcp -
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
-
"Missing required environment variables" error
- Ensure all required variables are set in your
.envfile - Check that the config in Claude Desktop matches your environment
- Ensure all required variables are set in your
-
Authentication failures
- Verify your Nango integration is properly configured
- Check that your Trello API key is correct
- Ensure the Nango connection is active
-
Server not appearing in Claude
- Restart Claude Desktop after configuration changes
- Check the file path in the Claude config is correct
- Verify the
uvcommand is available in your PATH
-
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
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- 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:
- Check the troubleshooting section above
- Review the MCP documentation
- Check Nango documentation
- Open an issue in this repository