Automação do ClickUp via Rube MCP

Automatize fluxos de trabalho de gerenciamento de projetos do ClickUp, incluindo criação e atualizações de tarefas, navegação na hierarquia do espaço de trabalho, comentários e gerenciamento de membros da equipe através do kit de ferramentas ClickUp da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o ClickUp via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas clickup
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas clickup
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir o OAuth do ClickUp
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar e Gerenciar Tarefas

Quando usar: O usuário deseja criar tarefas, subtarefas, atualizar propriedades de tarefas ou listar tarefas em uma lista do ClickUp.

Sequência de ferramentas:

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - Obter IDs de espaço de trabalho/equipe [Pré-requisito]
2. CLICKUP_GET_SPACES - Listar espaços em um espaço de trabalho [Pré-requisito]
3. CLICKUP_GET_FOLDERS - Listar pastas em um espaço [Pré-requisito]
4. CLICKUP_GET_FOLDERLESS_LISTS - Listar listas que não estão dentro de pastas [Opcional]
5. CLICKUP_GET_LIST - Validar lista e verificar status disponíveis [Pré-requisito]
6. CLICKUP_CREATE_TASK - Criar uma tarefa na lista de destino [Obrigatório]
7. CLICKUP_CREATE_TASK (com parent) - Criar subtarefa sob uma tarefa pai [Opcional]
8. CLICKUP_UPDATE_TASK - Modificar status da tarefa, atribuídos, datas, prioridade [Opcional]
9. CLICKUP_GET_TASK - Recuperar detalhes completos da tarefa [Opcional]
10. CLICKUP_GET_TASKS - Listar todas as tarefas em uma lista com filtros [Opcional]
11. CLICKUP_DELETE_TASK - Remover permanentemente uma tarefa [Opcional]

Parâmetros chave para CLICKUP_CREATE_TASK:

• list_id: ID da lista de destino (inteiro, obrigatório)
• name: Nome da tarefa (string, obrigatório)
• description: Descrição detalhada da tarefa
• status: Deve corresponder exatamente (sensível a maiúsculas e minúsculas) a um nome de status configurado na lista de destino
• priority: 1 (Urgente), 2 (Alta), 3 (Normal), 4 (Baixa)
• assignees: Array de IDs de usuário (inteiros)
• due_date: Timestamp Unix em milissegundos
• parent: ID da tarefa pai (string) para criar subtarefas
• tags: Array de nomes de tags (strings)
• time_estimate: Tempo estimado em milissegundos

Armadilhas:

• status é sensível a maiúsculas e minúsculas e deve corresponder a um status existente na lista; use CLICKUP_GET_LIST para verificar os status disponíveis
• due_date e start_date são timestamps Unix em milissegundos, não segundos
• A subtarefa parent deve ser uma tarefa (não outra subtarefa) na mesma lista
• notify_all aciona notificações de observadores; defina como falso para operações em massa
• Tentativas de repetição podem criar duplicatas; rastreie os IDs das tarefas criadas para evitar recriação
• custom_item_id para marcos (ID 1) está sujeito às cotas do plano do espaço de trabalho

2. Navegar na Hierarquia do Espaço de Trabalho

Quando usar: O usuário deseja navegar ou gerenciar a estrutura do espaço de trabalho do ClickUp (Espaços de Trabalho > Espaços > Pastas > Listas).

Sequência de ferramentas:

1. CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES - Listar todos os espaços de trabalho acessíveis [Obrigatório]
2. CLICKUP_GET_SPACES - Listar espaços dentro de um espaço de trabalho [Obrigatório]
3. CLICKUP_GET_SPACE - Obter detalhes de um espaço específico [Opcional]
4. CLICKUP_GET_FOLDERS - Listar pastas em um espaço [Obrigatório]
5. CLICKUP_GET_FOLDER - Obter detalhes de uma pasta específica [Opcional]
6. CLICKUP_CREATE_FOLDER - Criar uma nova pasta em um espaço [Opcional]
7. CLICKUP_GET_FOLDERLESS_LISTS - Listar listas que não estão dentro de nenhuma pasta [Obrigatório]
8. CLICKUP_GET_LIST - Obter detalhes da lista, incluindo status e campos personalizados [Opcional]

Parâmetros chave:

• team_id: ID do espaço de trabalho de GET_AUTHORIZED_TEAMS_WORKSPACES (obrigatório para espaços)
• space_id: ID do espaço (obrigatório para pastas e listas sem pasta)
• folder_id: ID da pasta (obrigatório para GET_FOLDER)
• list_id: ID da lista (obrigatório para GET_LIST)
• archived: Filtro booleano para itens arquivados/ativos

Armadilhas:

• A hierarquia do ClickUp é: Espaço de Trabalho (Equipe) > Espaço > Pasta > Lista > Tarefa
• Listas podem existir diretamente sob Espaços (sem pasta) ou dentro de Pastas
• Deve-se usar CLICKUP_GET_FOLDERLESS_LISTS para encontrar listas que não estão dentro de pastas; CLICKUP_GET_FOLDERS retorna apenas pastas
• team_id na API do ClickUp refere-se ao ID do Espaço de Trabalho, não a um grupo de usuários

3. Adicionar Comentários a Tarefas

…