Laissez un agent gérer votre liste de tâches

MCP ou la CLI ?

Préférez les outils MCP quand votre agent dispose déjà d'une connexion MCP à TaskForge. Ils sont typés, renvoient des erreurs structurées que l'agent peut utiliser pour se corriger, et n'exigent rien dans votre PATH. Passez plutôt par la CLI depuis des contextes shell sans connexion MCP : scripts, cron, CI, ou un agent de code qui travaille dans une copie locale d'un dépôt. Les deux pilotent le même moteur avec une sémantique identique, choisissez donc celui déjà branché dans votre environnement. Modifier les fichiers du coffre à la main reste le dernier recours.

Installation

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

Vous avez compilé taskforge depuis les sources plutôt que d'utiliser npx ? Pointez la configuration directement vers le binaire :

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

Bureau uniquement, puisque c'est là que vivent les clients MCP. taskforge est distribué sous la forme d'un seul binaire natif pour macOS, Windows et Linux, et le serveur MCP en est l'une des sous-commandes.

L'ensemble complet des outils

22 outils au total, qui couvrent tout le cycle de vie d'une tâche : créer, lire, mettre à jour, terminer, archiver et supprimer, chacun avec une variante en lot ; déplacer, reparenter et convertir entre une ligne en ligne et un fichier TaskNotes ; une vérification lint avant d'écrire une ligne ; un appel doctor pour l'état de santé du coffre ; et des ressources de schéma et de listes pour que l'agent apprenne votre format avant d'agir. Les six ci-dessous sont ceux que vous utiliserez le plus souvent. Chaque appel relit le coffre depuis le disque, donc l'agent agit toujours sur les fichiers actuels.

Chaque outil porte des annotations, pour qu'un client sache d'un coup d'œil quels appels ne font que lire, lesquels écrivent, et lequel supprime. Le reste de l'ensemble ajoute 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 et get_schema.

Trois ressources

En plus des outils, le serveur expose un contexte en lecture seule pour que l'agent apprenne les règles de votre coffre avant d'agir :

S'il ne trouve pas votre coffre

Le serveur démarre toujours, même avant de savoir où se trouve votre coffre, donc Claude Desktop n'affiche jamais un opaque "server failed to start". Quand un appel d'outil ne parvient pas à résoudre un coffre, il renvoie une erreur claire que l'agent peut relayer : définissez la variable d'environnement TASKFORGE_VAULT sur le chemin de votre coffre, ou réinstallez le pack et indiquez le dossier du coffre quand on vous le demande.

Local uniquement

taskforge mcp --stdio lit et écrit les fichiers markdown du coffre que vous configurez, et rien d'autre. Aucun compte, aucun cloud. Votre synchronisation existante, iCloud, Dropbox ou Obsidian Sync, déplace les modifications entre vos appareils.

Vous préférez un terminal ?

Si vous préférez scripter vos tâches ou lancer des commandes ponctuelles plutôt que de les piloter depuis un agent, la CLI taskforge couvre le même coffre avec les mêmes règles.

Questions fréquentes