Deixe um agente rodar sua lista de tarefas

MCP ou a CLI?

Prefira as ferramentas MCP quando seu agente já tiver uma conexão MCP com o TaskForge. Elas são tipadas, retornam erros estruturados que o agente pode usar para se autocorrigir, e não precisam de nada no seu PATH. Recorra à CLI em contextos de shell sem conexão MCP: scripts, cron, CI, ou um agente de código trabalhando em uma cópia local de um repositório. As duas rodam o mesmo motor com semântica idêntica, então escolha a que já está conectada no seu ambiente. Editar os arquivos do vault manualmente é o último recurso.

Instalação

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

Compilou o taskforge a partir do código-fonte em vez de usar o npx? Aponte a configuração direto para o binário:

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

Somente desktop, já que é onde os clientes MCP vivem. O taskforge é distribuído como um único binário nativo para macOS, Windows e Linux, e o servidor MCP é um dos seus subcomandos.

O conjunto completo de ferramentas

22 ferramentas ao todo, cobrindo todo o ciclo de vida de uma tarefa: criar, ler, atualizar, concluir, arquivar e excluir, cada uma com uma variante em lote; mover, reatribuir o item pai e converter entre uma linha inline e um arquivo TaskNotes; uma checagem de lint antes de você escrever uma linha; uma chamada doctor para a saúde do vault; e recursos de schema e listas, para que o agente aprenda seu formato antes de agir. As seis abaixo são as que você vai usar com mais frequência. Cada chamada relê o vault direto do disco, então o agente sempre age sobre os arquivos atuais.

Cada ferramenta agora carrega anotações, então um cliente sabe de relance quais chamadas só leem, quais gravam e qual exclui. O restante do conjunto inclui 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.

Três recursos

Além das ferramentas, o servidor expõe contexto somente leitura para que o agente aprenda as regras do seu vault antes de agir:

Se ele não encontrar o seu vault

O servidor sempre inicia, mesmo antes de saber onde está o seu vault, então o Claude Desktop nunca mostra um "falha ao iniciar o servidor" sem explicação. Quando uma chamada de ferramenta não consegue resolver um vault, ela retorna um erro claro que o agente pode repassar: defina a variável de ambiente TASKFORGE_VAULT com o caminho do seu vault, ou reinstale o pacote e informe o diretório do vault quando solicitado.

Somente local

O taskforge mcp --stdio lê e grava apenas os arquivos markdown do vault que você configurar, e nada além disso. Sem conta, sem nuvem. A sua sincronização já existente, iCloud, Dropbox ou Obsidian Sync, move as mudanças entre os dispositivos.

Prefere um terminal?

Se você quer automatizar suas tarefas com scripts ou rodar comandos avulsos em vez de deixar um agente conduzir, a CLI do taskforge cobre o mesmo vault com as mesmas regras.

Perguntas frequentes