Trello MCP-Server

🔀 Aktiver Fork. Dies ist ein gepflegter Fork von kocakli/Trello-Desktop-MCP, der Beiträge aus dem gesamten Fork-Ökosystem integriert (kevinhillinger, zonca, dbz-max, maks244, jantman, ThatIanMcShane, josh-argyle). Pull Requests sind willkommen – siehe Credits für die Beiträge der einzelnen Entwickler. Veröffentlicht auf npm als atlassian-trello-mcp.

Ein Model Context Protocol (MCP)-Server für Trello, der mit jedem MCP-kompatiblen Client funktioniert – Claude Desktop, Claude Code, Gemini CLI und mehr.

Bietet 46 Tools für Boards, Karten, Listen, Labels, Checklisten, Anhänge, Mitglieder, benutzerdefinierte Felder und die Suche.

Schnellstart

1. Trello API-Zugangsdaten abrufen

• Besuchen Sie https://trello.com/app-key

• Kopieren Sie Ihren API-Key

• Klicken Sie auf "Generate a Token" für Lese-/Schreibzugriff

2. Installation

Der einfachste Weg ist npx – kein Klonen, kein Build, einfach ausführen:

npx atlassian-trello-mcp

Oder aus dem Quellcode installieren:

git clone https://github.com/agrath/Trello-Desktop-MCP.git
cd Trello-Desktop-MCP
npm install
npm run build

3. MCP-Client konfigurieren

Bearbeiten Sie Ihre Konfigurationsdatei:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "atlassian-trello-mcp"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

claude mcp add trello -- npx -y atlassian-trello-mcp

Setzen Sie die Umgebungsvariablen TRELLO_API_KEY und TRELLO_TOKEN oder übergeben Sie die Zugangsdaten pro Anfrage.

Bearbeiten Sie ~/.gemini/settings.json:

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "atlassian-trello-mcp"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

Der Server verwendet den stdio-Transport. Führen Sie ihn mit gesetzten Umgebungsvariablen aus:

TRELLO_API_KEY=your-key TRELLO_TOKEN=your-token npx atlassian-trello-mcp
# or, from a source clone:
TRELLO_API_KEY=your-key TRELLO_TOKEN=your-token node dist/index.js

Related MCP server: fastmcp-trello

Zugangsdaten

Zugangsdaten können auf zwei Arten bereitgestellt werden:

1. Umgebungsvariablen (empfohlen): Setzen Sie TRELLO_API_KEY und TRELLO_TOKEN

2. Pro Anfrage: Übergeben Sie apiKey und token als Tool-Parameter (überschreibt Umgebungsvariablen)

Verfügbare Tools (46)

Boards & Listen

Karten

Kommentare & Aktivitäten

Labels

Mitglieder auf Karten

Anhänge

Checklisten

Checklisten-Elemente

Suche

Konfiguration

Schreibgeschützter Modus

Setzen Sie TRELLO_READ_ONLY=true, um alle Schreibvorgänge zu deaktivieren. Nur Lese-/Abfrage-Tools sind verfügbar.

{
  "env": {
    "TRELLO_API_KEY": "your-key",
    "TRELLO_TOKEN": "your-token",
    "TRELLO_READ_ONLY": "true"
  }
}

Kompakter Modus

Mehrere Tools unterstützen einen compact-Parameter (Standard: true), der nur minimale Felder zurückgibt, um die Antwortgröße zu reduzieren. Setzen Sie compact: false für vollständige Details, einschließlich Beschreibungen, Labels, Mitgliedern und benutzerdefinierten Feldern.

Tools mit kompaktem Modus: get_board_details, trello_get_board_cards, trello_get_list_cards, trello_search.

Bildanhang-Download

Wenn get_card aufgerufen wird und die Karte Bildanhänge enthält, lädt der Server diese herunter und gibt sie als Inline-MCP-Bildinhaltsblöcke neben dem JSON zurück – so kann der Client Kartenbilder direkt sehen. Downloads sind auf Trello-gehostete URLs (*.trello.com, trello-attachments.s3.amazonaws.com) beschränkt und auf 5 MB pro Bild begrenzt, um SSRF- und Payload-Größenrisiken zu mindern.

Setzen Sie TRELLO_DOWNLOAD_IMAGES=false (oder 0/no/off), um dies vollständig zu deaktivieren – der Server überspringt dann den zusätzlichen getCardAttachments-Aufruf und gibt nur Text zurück. Standardmäßig aktiviert.

Protokollierung

Setzen Sie TRELLO_MCP_LOGGING=true, um die dateibasierte Protokollierung über Pino zu aktivieren. Protokolle werden in dist/logs/app.log geschrieben.

Entwicklung

Projektstruktur

src/
  index.ts              Entry point (credential injection, tool routing)
  server.ts             MCP server factory (read-only mode support)
  tools/
    boards.ts           Board tools (list, details, lists, filter)
    cards.ts            Card tools (CRUD, archive)
    lists.ts            List tools (cards, create list, comments)
    members.ts          Member tools (user boards, member details)
    search.ts           Search tool
    advanced.ts         Labels, attachments, members on cards, custom fields
    checklists.ts       Checklist and check item tools (13 tools)
  trello/
    client.ts           TrelloClient (API calls, retry, rate limiting)
  types/
    trello.ts           TypeScript interfaces
  utils/
    validation.ts       Zod schemas, extractCredentials, extractTrelloId
    logger.ts           Pino file logger
    health.ts           Health check utility
    appInsights.ts      Telemetry (no-op)
tests/
  validation.test.ts    Validation and credential extraction tests
  trelloClient.test.ts  API client tests (mocked fetch)
  tools.test.ts         Tool handler tests (mocked client)

Build & Test

npm install
npm run build
npm test
npm run type-check

Wichtige Muster

• ID-Auflösung: Alle Tools akzeptieren Trello-URLs, Kurz-IDs oder vollständige 24-stellige Hex-IDs via extractTrelloId()

• Fallback für Zugangsdaten: extractCredentials() prüft zuerst Argumente, dann Umgebungsvariablen

• Wiederholung mit Backoff: TrelloClient wiederholt bei 500/Netzwerkfehlern (3 Versuche, exponentielles Backoff)

• Ratenbegrenzung: Extrahiert und gibt x-rate-limit-*-Header aus jeder Antwort zurück

• Validierung: Zod-Schemas validieren alle Eingaben vor API-Aufrufen

Mitwirken

Pull Requests sind willkommen und werden aktiv geprüft. Dieser Fork wird von einem intensiven Trello-Nutzer gepflegt, daher werden Funktionen in der Praxis getestet.

Wenn Sie das ursprüngliche Projekt geforkt und etwas Nützliches gebaut haben, reichen Sie bitte hier einen PR ein, anstatt einen separaten Fork zu pflegen – es ist für alle einfacher, von einem einzigen, gut gepflegten Projekt zu profitieren.

So wirken Sie mit:

1. Forken Sie dieses Repo

2. Erstellen Sie einen Feature-Branch

3. Fügen Sie Tests für neue Funktionen hinzu

4. Führen Sie npm test und npm run build aus

5. Reichen Sie einen Pull Request mit einer klaren Beschreibung von "Was" und "Warum" ein

Credits

Dieses Projekt ist ein Fork von kocakli/Trello-Desktop-MCP. Funktionen und Ideen wurden aus dem gesamten Fork-Ökosystem übernommen:

• kocakli -- Ursprüngliches Projekt, MCP-Client-agnostisches Rebranding, Korrektur der stderr-Protokollierung

• kevinhillinger -- Architektur zur Injektion von Zugangsdaten, Label-Löschung, Kartenmitgliederverwaltung, Kartenarchivierung, erweiterte TypeScript-Typen, Ressourcen-Ebene

• zonca -- Zentralisierte Handhabung von Zugangsdaten mit Fallback auf Umgebungsvariablen, Label-Management-Tools, umfassende Unit-Tests, verbesserte TypeScript-Typen (ersetzt any)

• dbz-max -- Unterstützung für benutzerdefinierte Felder (Board-Felder + Karten-Feld-Elemente)

• maks244 -- Konzept für schreibgeschützten Modus, Listenfilterung nach Name, Entfernen von Zugangsdaten aus Telemetrie-Protokollen

• jantman -- Korrektur für numerische pos-Werte, die von MCP-Clients als Strings abgelehnt wurden

• ThatIanMcShane -- Aktualisierung von @modelcontextprotocol/sdk 1.0.4 auf 1.29.0 zur Behebung von Verbindungs-Timeouts bei aktuellen Claude Code-Releases

• josh-argyle -- Automatischer Download von Bildanhängen in get_card-Antworten als Inline-MCP-Bildinhaltsblöcke (mit während des Ports hinzugefügter Positivliste + Größenbeschränkung)

Lizenz

MIT