Automação do Todoist via Rube MCP

Automatize operações do Todoist, incluindo criação e gerenciamento de tarefas, organização de projetos, gerenciamento de seções, filtragem e fluxos de trabalho de tarefas em massa através do kit de ferramentas Todoist da Composio.

Pré-requisitos

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

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu 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 todoist
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Todoist
4. Confirme se o status da conexão mostra ATIVA antes de executar qualquer fluxo de trabalho

Fluxos de Trabalho Principais

1. Criar e Gerenciar Tarefas

Quando usar: O usuário deseja criar, atualizar, completar, reabrir ou excluir tarefas

Sequência de ferramentas:

1. TODOIST_GET_ALL_PROJECTS - Listar projetos para encontrar o ID do projeto de destino [Pré-requisito]
2. TODOIST_GET_ALL_SECTIONS - Listar seções dentro de um projeto para posicionamento de tarefas [Opcional]
3. TODOIST_CREATE_TASK - Criar uma única tarefa com conteúdo, data de vencimento, prioridade, rótulos [Obrigatório]
4. TODOIST_BULK_CREATE_TASKS - Criar várias tarefas em uma única solicitação [Alternativa]
5. TODOIST_UPDATE_TASK - Modificar propriedades da tarefa (conteúdo, data de vencimento, prioridade, rótulos) [Opcional]
6. TODOIST_CLOSE_TASK - Marcar uma tarefa como concluída [Opcional]
7. TODOIST_REOPEN_TASK - Restaurar uma tarefa previamente concluída [Opcional]
8. TODOIST_DELETE_TASK - Remover permanentemente uma tarefa [Opcional]

Parâmetros-chave para CREATE_TASK:

• content: Título da tarefa (suporta markdown e hiperlinks)
• description: Notas adicionais (NÃO coloque datas de vencimento aqui)
• project_id: ID do projeto alfanumérico; omita para adicionar à Caixa de Entrada
• section_id: ID da seção alfanumérica para posicionamento dentro de um projeto
• parent_id: ID da tarefa para criar subtarefas
• priority: 1 (normal) a 4 (urgente) — observação: a interface do usuário do Todoist mostra p1=urgente, a API p4=urgente
• due_string: Data em linguagem natural como "tomorrow at 3pm", "every Friday at 9am"
• due_date: Data específica no formato YYYY-MM-DD
• due_datetime: Data+hora específica no formato RFC3339 YYYY-MM-DDTHH:mm:ssZ
• labels: Matriz de strings de nomes de rótulos
• duration + duration_unit: Duração da tarefa (por exemplo, 30 + "minute")

Armadilhas:

• Apenas um campo due_* pode ser usado por vez (exceto due_lang, que pode acompanhar qualquer um)
• NÃO incorpore datas de vencimento em content ou description — use o campo due_string
• NÃO incorpore frases de duração como "por 30 minutos" em due_string — use duration + duration_unit
• priority na API: 1=normal, 4=urgente (o oposto da exibição da interface do usuário do Todoist, onde p1=urgente)
• Os IDs de tarefa podem ser numéricos ou alfanuméricos; use o formato retornado pela API
• CLOSE_TASK marca como concluído; DELETE_TASK remove permanentemente — são operações diferentes

2. Gerenciar Projetos

Quando usar: O usuário deseja listar, criar, atualizar ou inspecionar projetos

Sequência de ferramentas:

1. TODOIST_GET_ALL_PROJECTS - Listar todos os projetos com metadados [Obrigatório]
2. TODOIST_GET_PROJECT - Obter detalhes de um projeto específico por ID [Opcional]
3. TODOIST_CREATE_PROJECT - Criar um novo projeto com nome, cor, estilo de visualização [Opcional]
4. TODOIST_UPDATE_PROJECT - Modificar propriedades do projeto [Opcional]

Parâmetros-chave:

• name: Nome do projeto (obrigatório para criação)
• color: Cor da paleta do Todoist (por exemplo, "blue", "red", "green", "charcoal")
• view_style: Layout "list" ou "board"
• parent_id: ID do projeto pai para criar subprojetos
• is_favorite / favorite: Booleano para marcar como favorito
• project_id: Necessário para operações de atualização e obtenção

Armadilhas:

• Projetos com nomes semelhantes podem levar à seleção do ID de projeto errado; sempre verifique
• CREATE_PROJECT usa favorite enquanto UPDATE_PROJECT usa is_favorite — nomes de campo diferentes
• Use o id do projeto retornado pela API, não o v2_id, para operações downstream
• IDs de projeto alfanuméricos/estilo URL podem causar HTTP 400 em algumas ferramentas; use o ID numérico, se disponível

3. Gerenciar Seções

Quando usar: O usuário deseja organizar tarefas dentro de projetos usando seções

Sequência de ferramentas:

1. TODOIST_GET_ALL_PROJECTS - Encontrar o ID do projeto de destino [Pré-requisito]
2. TODOIST_GET_ALL_SECTIONS - Listar seções existentes para evitar duplicatas [Pré-requisito]

…