Mtl Trello

License: MIT CI Python 3.10+ Code style: Ruff Built by MusicTech Lab

Model Context Protocol (MCP) server for Trello project management.

Manage boards, lists, cards, labels, and members - all from Claude Code or any MCP-compatible client.

Tools

Setup

1. Get Trello API credentials

1. Register a Trello Power-Up
2. Note your API Key and generate a Token from the Power-Up admin page

2. Configure environment

cp .env.example .env
# Edit .env with your TRELLO_API_KEY and TRELLO_TOKEN

Attachment upload safety. The attachment tools (trello_add_attachment, trello_comment_with_attachment) validate every local path before uploading, to stop a prompt-injected path from leaking a sensitive file onto a card:

Sensitive filename patterns (*.pem, *.key, *.env, id_rsa, .netrc, …) are rejected regardless. For the strictest setup, point TRELLO_UPLOAD_DIR at a dedicated staging folder that contains nothing else.

3. Install dependencies

poetry install

4. Add to Claude Code

claude mcp add mtl-trello -- poetry -C /path/to/mtl-trello-mcp run python -m mtl_trello_mcp

Or add it manually to your Claude Code MCP settings:

{
  "mtl-trello": {
    "type": "stdio",
    "command": "poetry",
    "args": ["-C", "/path/to/mtl-trello-mcp", "run", "python", "-m", "mtl_trello_mcp"],
    "env": {
      "TRELLO_API_KEY": "your-api-key",
      "TRELLO_TOKEN": "your-token"
    }
  }
}

Usage examples

Once configured, you can ask Claude:

• "Show me all my Trello boards"
• "What cards are on the MTL board?"
• "Create a card 'Fix ISRC validation' in the BACKLOG list"
• "Move card abc123 to the DONE list"
• "Search Trello for 'audio fingerprinting'"
• "Translate all card names on this board to English"

Development

# Install dev dependencies
poetry install

# Run the server directly
poetry run python -m mtl_trello_mcp

# Run tests
poetry run pytest

# Run linter
poetry run ruff check .

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before submitting a PR.

Security

To report a vulnerability, please see SECURITY.md.

License

MIT - see LICENSE for details.