Lassen Sie einen Agenten Ihre To-do-Liste führen

MCP oder die CLI?

Bevorzugen Sie die MCP-Tools, wenn Ihr Agent bereits eine MCP-Verbindung zu TaskForge hat. Sie sind typisiert, liefern strukturierte Fehler, anhand derer sich der Agent selbst korrigieren kann, und brauchen nichts in Ihrem PATH. Greifen Sie stattdessen aus Shell-Kontexten ohne MCP-Verbindung zur CLI: Skripte, Cron, CI oder ein Coding-Agent, der in einem Repo-Checkout arbeitet. Beide steuern dieselbe Engine mit identischer Semantik, wählen Sie also, was in Ihrer Umgebung bereits eingerichtet ist. Vault-Dateien von Hand zu bearbeiten, ist die letzte Option.

Installation

{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

Unter Windows gehört cmd /c vor npx. Desktop-MCP-Clients wie Claude Desktop starten den Server ohne Shell, und npx ist ein .cmd-Skript, das Windows nur über eine Shell ausführt:

{
  "mcpServers": {
    "taskforge": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "C:\\path\\to\\your\\vault"
      }
    }
  }
}

Haben Sie taskforge selbst aus dem Quellcode gebaut, statt npx zu nutzen? Verweisen Sie in der Konfiguration direkt auf das Binary:

"command": "taskforge",
"args": ["mcp", "--stdio"]

Nur für den Desktop, denn dort laufen MCP-Clients. taskforge wird als ein einziges natives Binary für macOS und Windows ausgeliefert, und der MCP-Server ist einer seiner Unterbefehle. Linux kommt bald.

Das vollständige Tool-Set

30 Tools insgesamt, die den gesamten Lebenszyklus von Aufgaben und Notizen abdecken: Erstellen, Lesen, Aktualisieren, Abschließen, Archivieren und Löschen, jeweils mit einer Sammelvariante; Verschieben, Neuzuordnen und Umwandeln zwischen einer Inline-Zeile und einer Aufgabendatei; Notizen erstellen, umbenennen, löschen und bearbeiten, ohne Links zu beschädigen; eine Lint-Prüfung, bevor Sie eine Zeile schreiben; ein doctor-Aufruf, der den Zustand des Vaults prüft; sowie Dialekt- und Spaces-Ressourcen, damit der Agent Ihr Format kennenlernt, bevor er handelt. Die folgenden sechs brauchen Sie am häufigsten. Jeder Aufruf liest den Vault frisch von der Festplatte, sodass der Agent immer mit den aktuellen Dateien arbeitet.

Jedes Tool trägt Annotationen, sodass ein Client auf einen Blick erkennt, welche Aufrufe nur lesen, welche schreiben und welcher löscht. Der Rest des Sets umfasst bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_spaces, get_dialect, create_note, read_note, update_note, patch_note_block, patch_note_frontmatter, normalize_references, delete_note und move_note.

Drei Ressourcen

Neben den Tools stellt der Server schreibgeschützten Kontext bereit, damit der Agent die Regeln Ihres Vaults kennt, bevor er handelt:

Wenn der Server Ihren Vault nicht findet

Der Server startet immer, selbst bevor er weiß, wo Ihr Vault liegt, sodass Claude Desktop nie ein undurchsichtiges „server failed to start“ anzeigt. Kann ein Tool-Aufruf keinen Vault auflösen, gibt er einen einfachen Fehler zurück, den der Agent weitergeben kann: Setzen Sie die Umgebungsvariable TASKFORGE_VAULT auf Ihren Vault-Pfad, oder installieren Sie das Bundle neu und geben Sie den Vault-Ordner ein, wenn Sie dazu aufgefordert werden.

Nur lokal

Der TaskForge-MCP-Server läuft lokal und liest und schreibt die Markdown-Dateien Ihres Vaults. Die Installation über npx lädt das Paket von npm herunter. Ihr KI-Client kann Tool-Eingaben und -Ergebnisse an seinen Anbieter senden; dessen Datenschutzeinstellungen gelten weiterhin. Ihre bestehende Vault-Synchronisierung überträgt die Änderungen zwischen Ihren Geräten.

Lieber ein Terminal?

Wenn Sie Ihre Aufgaben lieber skripten oder einmalige Befehle ausführen möchten, statt sie von einem Agenten steuern zu lassen, deckt die taskforge CLI denselben Vault mit denselben Regeln ab.

Fragen, die Nutzer stellen