TaskWarrior MCP Server
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 aktualisierenmark_task_done- Aufgabe per UUID abschließendelete_task- Aufgabe per UUID löschenlist_tasks- Aufgaben mit Filtern abfragen (status, project, tags, dates)get_task_details- Einzelne Aufgabe per UUID abrufenstart_task- Timer für Aufgabe startenstop_task- Timer für Aufgabe stoppenadd_annotation- Notiz zu Aufgabe hinzufügenremove_annotation- Notiz von Aufgabe entfernen
Abhängigkeiten
add_dependency- Aufgabe A von Aufgabe B abhängig machenremove_dependency- Abhängigkeitsverknüpfung entfernen
GTD-Workflow
get_next_actions- Ausführbare Aufgaben nach Kontext, Energieniveau und verfügbarer Zeit filternprocess_inbox- Aufgaben mit Tag +inbox zur Verarbeitung abrufenget_waiting_for- Delegierte/wartende Aufgaben abrufen, gruppiert nach Blocker/Datum/Projektget_blocked_tasks- Aufgaben mit unerfüllten Abhängigkeiten abrufenget_project_status- Projektkennzahlen: nächste Aktionen, Fertigstellungsgrad %, Veraltungweekly_review- GTD-Review-Daten: Posteingang, abgeschlossen, stockende Projekte, Gewohnheitenget_someday_maybe- Aufgaben mit Tag +someday abrufen
Batch-Operationen
create_project_tree- Projekt mit mehreren Aufgaben und Abhängigkeiten in einem Aufruf erstellenbatch_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
taskverfügbar
Installation
bun install
bun run buildAusführen
bun run startOder 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:packDas 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 Aufgabenobjektenmetadata- Zählungen (gesamt, ausführbar, blockiert, wartend, abgeschlossen)insights- Zusammenfassung, Empfehlungen, Warnungengroups- Aufgaben gruppiert nach Projekt/Kontext/Häufigkeitrelationships- Abhängigkeitsketten (sofern zutreffend)
GTD-Funktionen
Aufgabenfelder
scheduled- Datum für den Arbeitsbeginnwait- Bis zu einem Datum ausblenden (aufgeschoben)until- Aufgabe läuft nach dem Datum abcontext- GTD-Kontext (@home, @work, @phone)energy- Erforderliches Energieniveau (H/M/L)depends- Array von Aufgaben-UUIDs, von denen diese abhängtparent- UUID der übergeordneten Aufgaberecur- Wiederholungsmuster (täglich, wöchentlich, monatlich usw.)tags- Buchstaben, Ziffern,_und-. Tag-Schreibvorgänge verwenden dastags:-Attribut von Taskwarrior und Tag-Filter verwendentags.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 buildTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
ADHD-friendly task management MCP server for ChaTodo: organize tasks, lists, and priorities.
MCP server for Google Tasks: review, plan and tidy your tasks by asking. Deletes always ask first.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to interact with the Taskwarrior command-line task management tool. It allows users to list, create, modify, and organize tasks using projects, tags, and annotations through natural language.132MIT
- FlicenseNot gradedqualityDmaintenanceRemote MCP server for managing TickTick tasks and projects, offering 22 tools for CRUD, search, and GTD workflows via any MCP client.1-
- AlicenseAqualityCmaintenanceMCP server for Taskwarrior 3.x — 35 tools for task lifecycle, time tracking, schema validation, and role-based permissions.3574 PyPI3Apache 2.0
- AlicenseNot gradedqualityDmaintenanceAn MCP server that wraps the Taskwarrior CLI to allow AI assistants to create, query, modify, and manage tasks directly from agentic coding tools.MIT