# 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
```bash
git clone <your-repo-url>
cd trello-mcp
```
### Step 2: Install Dependencies
Using UV (recommended):
```bash
uv sync
```
Or using pip:
```bash
pip install -e .
```
### Step 3: Environment Configuration
Create a `.env` file in the project root:
```env
# 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`
```json
{
"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"
}
}
}
}
```
## 🔧 Setup Guide
### Getting Your Credentials
#### 1. Nango Setup
1. Sign up at [Nango.dev](https://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](https://trello.com/app-key)
2. Get your API Key (this becomes your `TRELLO_CLIENT_ID`)
### Testing the Installation
1. **Test the server directly:**
```bash
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](https://modelcontextprotocol.io/)
3. Check [Nango documentation](https://docs.nango.dev/)
4. Open an issue in this repository
## 🔗 Related Links
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [Nango Documentation](https://docs.nango.dev/)
- [Trello API Documentation](https://developer.atlassian.com/cloud/trello/)
- [Claude Desktop](https://claude.ai/)
