Lascia che un agente gestisca la tua lista di cose da fare

MCP o la CLI?

Preferisci gli strumenti MCP quando il tuo agente ha già una connessione MCP a TaskForge. Sono tipizzati, restituiscono errori strutturati su cui l'agente può autocorreggersi, e non richiedono nulla nel tuo PATH. Ricorri invece alla CLI da contesti di shell senza connessione MCP: script, cron, CI, o un agente di coding che lavora in una copia locale di un repository. Entrambi guidano lo stesso motore con semantica identica, scegli quindi quello già collegato nel tuo ambiente. Modificare i file del vault a mano resta l'ultima risorsa.

Installazione

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

Hai compilato taskforge dal codice sorgente invece di usare npx? Punta la configurazione direttamente al binario:

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

Solo desktop, perché è lì che vivono i client MCP. taskforge viene distribuito come un unico binario nativo per macOS, Windows e Linux, e il server MCP è uno dei suoi sottocomandi.

L'intero set di strumenti

22 strumenti in totale, che coprono l'intero ciclo di vita di un'attività: creare, leggere, aggiornare, completare, archiviare ed eliminare, ciascuno con una variante bulk; spostare, riassegnare il genitore e convertire tra una riga inline e un file TaskNotes; un controllo lint prima di scrivere una riga; una chiamata doctor per lo stato di salute del vault; e risorse di schema e liste, così l'agente impara il tuo formato prima di agire. I sei qui sotto sono quelli che userai più spesso. Ogni chiamata rilegge il vault dal disco, quindi l'agente agisce sempre sui file attuali.

Ogni strumento porta delle annotazioni, così un client sa a colpo d'occhio quali chiamate leggono soltanto, quali scrivono e quale elimina. Il resto del set aggiunge 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 e get_schema.

Tre risorse

Accanto agli strumenti, il server espone un contesto in sola lettura, così l'agente impara le regole del tuo vault prima di agire:

Se non riesce a trovare il tuo vault

Il server si avvia sempre, anche prima di sapere dove si trova il tuo vault, così Claude Desktop non mostra mai un opaco "server failed to start". Quando una chiamata a uno strumento non riesce a risolvere un vault, restituisce un errore chiaro che l'agente può riportare: imposta la variabile d'ambiente TASKFORGE_VAULT sul percorso del tuo vault, oppure reinstalla il pacchetto e inserisci la cartella del vault quando richiesto.

Solo in locale

taskforge mcp --stdio legge e scrive solo i file markdown nel vault che configuri, e nient'altro. Nessun account, nessun cloud. La sincronizzazione che già usi, iCloud, Dropbox o Obsidian Sync, sposta le modifiche tra i dispositivi.

Preferisci un terminale?

Se preferisci scriptare le tue attività o eseguire comandi una tantum invece di farle guidare da un agente, la CLI taskforge copre lo stesso vault con le stesse regole.

Domande frequenti