Hierarquia do ClickUpfy: workspace, Space, Folder e List

Classificação

A ordem dos recursos

O ClickUp organiza o trabalho nesta cadeia:

1
Workspace
2
└── Space
3
    ├── List sem Folder
4
    └── Folder
5
        └── List

Sprints também são Lists, mas vivem normalmente dentro de um Sprint Folder e possuem start_date e due_date.

O account já conhece um workspace. Por isso, space list não exige esse ID. A partir do Space, os comandos precisam do pai para evitar uma busca ambígua.

Liste workspaces e Spaces

1
clickupfy workspace list
2
clickupfy space list
3
clickupfy space list --archived

O asterisco na saída compacta indica o workspace associado ao account. Use --archived somente quando precisar localizar uma estrutura antiga.

Liste Folders e Lists

1
clickupfy folder list --space <space-id>
2
clickupfy list list --folder <folder-id>

Para Lists que pertencem diretamente ao Space:

1
clickupfy list list --space <space-id>

Folder e Space são alternativas no comando de Lists. Não informe os dois ao mesmo tempo.

Confira os status da List

1
clickupfy list get <list-id>

Essa leitura é importante antes de atualizar uma tarefa. Os nomes e tipos de status são configuráveis no ClickUp. Uma equipe pode usar feito, outra concluído, e uma terceira pode manter mais de um estado terminal.

Registre o ID da List e escolha um status terminal existente. Não assuma que done ou complete será aceito.

Liste e busque tarefas

1
clickupfy task list --list <list-id>
2
clickupfy task search --query "autenticação"

task list consulta uma List conhecida. task search procura no workspace, mas o MCP de projeto restringe a busca à List fixada para impedir vazamento de contexto entre projetos.

Use --json quando precisar inspecionar campos não exibidos na tabela:

1
clickupfy --json task list --list <list-id>

A opção global vem antes do grupo do comando.

Escolha o menor escopo suficiente

Um MCP de projeto sempre exige List. Space e Folder ajudam as ferramentas de navegação, mas não ampliam o destino de criação. Sprint Folder só deve ser configurado quando as Sprints do projeto estiverem dentro dele.

Para um projeto com List diretamente no Space:

1
clickupfy --account produto agent init \
2
  --space 10 \
3
  --list 30

Para um projeto com Folder e Sprints:

1
clickupfy --account produto agent init \
2
  --space 10 \
3
  --folder 20 \
4
  --list 30 \
5
  --sprint-folder 40

Continue em tarefas e checklists.