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, an denen 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"
      }
    }
  }
}

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

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

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

Das vollständige Tool-Set

22 Tools insgesamt, die den gesamten Aufgaben-Lebenszyklus abdecken: Erstellen, Lesen, Aktualisieren, Abschließen, Archivieren und Löschen, jeweils mit einer Bulk-Variante; Verschieben, Neuzuordnen und Umwandeln zwischen einer Inline-Zeile und einer TaskNotes-Datei; eine Lint-Prüfung vor dem Schreiben einer Zeile; ein doctor-Aufruf für die Vault-Gesundheit; sowie Schema- und Listen-Ressourcen, damit der Agent Ihr Format kennenlernt, bevor er handelt. Die sechs unten sind die, die Sie am häufigsten brauchen. 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 außerdem 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_task_lists und get_schema.

Drei Ressourcen

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

Wenn er 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

taskforge mcp --stdio liest und schreibt nur die Markdown-Dateien im Vault, den Sie konfigurieren, und sonst nichts. Kein Konto, keine Cloud. Ihre bestehende Synchronisation, iCloud, Dropbox oder Obsidian Sync, ü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