# Trello MCP Server
An MCP (Model Context Protocol) server that uses Trello as a knowledge base for storing and retrieving code snippets, notes, and other information.
# Attention(!!)
Claude wrote this. I didnt verify line by line what it wrote. So be aware when using this and do your own review. I provide this repo as is and will not be responsible for any damages this causes.
## Features
- Store code snippets and notes as Trello cards
- Search across card titles, descriptions, and labels
- Organize knowledge by boards and lists
- Tag-based categorization using Trello labels
- Full CRUD operations on your knowledge base
## Setup
**Prerequisites**: Make sure you have [direnv](https://direnv.net/) installed for environment variable management.
1. **Get Trello API credentials:**
- First, create a Power-Up at https://trello.com/power-ups/admin (required for API access)
- Go to your Power-Up's "API Key" tab and generate a new API key
- Generate a Token by clicking the Token link (its hidden in the text)
- Copy both your API Key and Token
2. **Create a Knowledge Board:**
- Create a new Trello board for your knowledge base
- Create lists like "Code Snippets", "Configuration", "Notes", etc.
- Copy the board ID from the URL
3. **Configure environment with direnv:**
```bash
# Edit .envrc with your Trello credentials
# Make sure direnv is installed and allowed for this directory
direnv allow
```
4. **Install and run:**
```bash
npm install
npm start
```
5. **Configure Claude Desktop:**
Add this to your Claude Desktop configuration file:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
**Linux**: `~/.config/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"trello-knowledge": {
"command": "node",
"args": ["src/index.js"],
"cwd": "/path/to/your/trello-mcp-server",
"env": {
"TRELLO_API_KEY": "your_api_key_here",
"TRELLO_TOKEN": "your_token_here",
"TRELLO_KNOWLEDGE_BOARD_ID": "your_board_id_here"
}
}
}
}
```
**Windows PowerShell** (if Node.js isn't in PATH):
```json
{
"mcpServers": {
"trello-knowledge": {
"command": "C:\\Program Files\\nodejs\\node.exe",
"args": ["C:\\Users\\YourUsername\\path\\to\\trello-mcp-server\\src\\index.js"],
"env": {
"TRELLO_API_KEY": "your_api_key_here",
"TRELLO_TOKEN": "your_token_here",
"TRELLO_KNOWLEDGE_BOARD_ID": "your_board_id_here"
}
}
}
}
```
**Alternative with direnv** (if you want Claude Desktop to inherit your shell environment):
```json
{
"mcpServers": {
"trello-knowledge": {
"command": "bash",
"args": ["-c", "cd /path/to/your/trello-mcp-server && eval \"$(direnv export bash)\" && node src/index.js"],
"cwd": "/path/to/your/trello-mcp-server"
}
}
}
```
6. **Restart Claude Desktop** for the changes to take effect.
## Usage
Once connected to Claude Desktop, you can:
- **Store knowledge:** "Remember that in Symfony, to prettify JSON responses, I use..."
- **Retrieve knowledge:** "How did I handle JSON responses in Symfony?"
- **Search:** "Show me all my Docker-related snippets"
- **Organize:** Cards are automatically tagged and categorized
## MCP Tools Available
- `store_knowledge` - Save a new piece of information
- `search_knowledge` - Find existing information
- `get_knowledge` - Retrieve specific knowledge by ID
- `list_topics` - Show all available topics/categories
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
