TaskWarrior MCP Server

MCP-Server, der das TaskWarrior-Kommandozeilenwerkzeug kapselt. Bietet 22 Werkzeuge für Aufgabenverwaltung, GTD-Workflow und Gewohnheitsverfolgung.

Werkzeuge

Grundlegende Aufgabenoperationen

• add_task - Aufgabe erstellen. Unterstützt GTD-Felder (context, energy, scheduled, wait, depends) und wiederkehrende Aufgaben (recur)

• modify_task - Aufgabenattribute aktualisieren

• mark_task_done - Aufgabe per UUID abschließen

• delete_task - Aufgabe per UUID löschen

• list_tasks - Aufgaben mit Filtern abfragen (status, project, tags, dates)

• get_task_details - Einzelne Aufgabe per UUID abrufen

• start_task - Timer für Aufgabe starten

• stop_task - Timer für Aufgabe stoppen

• add_annotation - Notiz zu Aufgabe hinzufügen

• remove_annotation - Notiz von Aufgabe entfernen

Abhängigkeiten

• add_dependency - Aufgabe A von Aufgabe B abhängig machen

• remove_dependency - Abhängigkeitsverknüpfung entfernen

GTD-Workflow

• get_next_actions - Ausführbare Aufgaben nach Kontext, Energieniveau und verfügbarer Zeit filtern

• process_inbox - Aufgaben mit Tag +inbox zur Verarbeitung abrufen

• get_waiting_for - Delegierte/wartende Aufgaben abrufen, gruppiert nach Blocker/Datum/Projekt

• get_blocked_tasks - Aufgaben mit unerfüllten Abhängigkeiten abrufen

• get_project_status - Projektkennzahlen: nächste Aktionen, Fertigstellungsgrad %, Veraltung

• weekly_review - GTD-Review-Daten: Posteingang, abgeschlossen, stockende Projekte, Gewohnheiten

• get_someday_maybe - Aufgaben mit Tag +someday abrufen

Batch-Operationen

• create_project_tree - Projekt mit mehreren Aufgaben und Abhängigkeiten in einem Aufruf erstellen

• batch_modify_tasks - Dieselben Änderungen auf mehrere Aufgaben anwenden

Gewohnheiten/Wiederkehrende Aufgaben

• get_recurring_tasks - Wiederkehrende Aufgaben mit Abschlussstatistiken, Serien und Häufigkeit abrufen

Related MCP server: TickTick MCP Server

Anforderungen

• Node.js 18+ für die Laufzeit

• Bun 1.3+ für Entwicklungs-Workflows

• TaskWarrior installiert und als task verfügbar

Installation

bun install
bun run build

Ausführen

bun run start

Oder konfigurieren Sie es in den Einstellungen Ihres MCP-Clients:

{
  "mcpServers": {
    "taskwarrior": {
      "command": "node",
      "args": ["/path/to/taskwarrior-mcp/dist/index.js"]
    }
  }
}

Claude Desktop Bundle

Dieses Repository enthält jetzt ein MCPB-Manifest für Claude Desktop.

bun run mcpb:validate
bun run mcpb:pack

Das erzeugt dist/taskwarrior-mcp.mcpb.

Das Bundle verpackt den MCP-Server, bündelt aber TaskWarrior selbst nicht. Benutzer benötigen weiterhin task auf dem Host-Rechner installiert. Für nicht standardmäßige Einrichtungen stellt das MCPB-Manifest optionale TASK_BIN- und TASKRC-Einstellungen bereit.

Antwortformat

Alle Werkzeuge geben das MCP-Standardformat zurück:

{
  "content": [
    {
      "type": "text",
      "text": "{\"tasks\": [...], \"metadata\": {...}, \"insights\": {...}}"
    }
  ]
}

GTD-Werkzeuge geben angereicherte Antworten zurück mit:

• tasks - Array von Aufgabenobjekten

• metadata - Zählungen (gesamt, ausführbar, blockiert, wartend, abgeschlossen)

• insights - Zusammenfassung, Empfehlungen, Warnungen

• groups - Aufgaben gruppiert nach Projekt/Kontext/Häufigkeit

• relationships - Abhängigkeitsketten (sofern zutreffend)

GTD-Funktionen

Aufgabenfelder

• scheduled - Datum für den Arbeitsbeginn

• wait - Bis zu einem Datum ausblenden (aufgeschoben)

• until - Aufgabe läuft nach dem Datum ab

• context - GTD-Kontext (@home, @work, @phone)

• energy - Erforderliches Energieniveau (H/M/L)

• depends - Array von Aufgaben-UUIDs, von denen diese abhängt

• parent - UUID der übergeordneten Aufgabe

• recur - Wiederholungsmuster (täglich, wöchentlich, monatlich usw.)

• tags - Buchstaben, Ziffern, _ und -. Tag-Schreibvorgänge verwenden das tags:-Attribut von Taskwarrior und Tag-Filter verwenden tags.has:, da die +tag-Kurzform Bindestriche ablehnt und stillschweigend die Beschreibung umschreibt.

Wiederkehrende Aufgaben

Setzen Sie recur zusammen mit due, um Gewohnheiten zu erstellen:

{
  "description": "Take vitamins",
  "recur": "daily",
  "due": "today",
  "context": "@morning"
}

TaskWarrior erstellt eine Vorlagenaufgabe (status:recurring), die Instanzen generiert. Verwenden Sie get_recurring_tasks, um Abschlussraten und Serien zu sehen.

Entwicklung

bun run typecheck  # Type check source
bun run lint       # Lint source
bun run test       # Run integration tests against disposable Taskwarrior data
bun run build      # Build dist/
bun run check      # Run typecheck, lint, tests, and build