# 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.