ComposioHQ/googletasks-automation

Automação do Google Tasks via Rube MCP

Crie, gerencie, organize e opere em lote tarefas e listas de tarefas do Google Tasks usando o Rube MCP (Composio).

Documentação do toolkit: composio.dev/toolkits/googletasks

Pré-requisitos

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

Configuração

Obter 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 ele funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit googletasks
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme que o status da conexão mostra ATIVA antes de executar qualquer fluxo de trabalho

Fluxos de Trabalho Principais

1. Listar Todas as Listas de Tarefas

Use GOOGLETASKS_LIST_TASK_LISTS para buscar todas as listas de tarefas disponíveis para o usuário autenticado.

Ferramenta: GOOGLETASKS_LIST_TASK_LISTS
Parâmetros:
  - maxResults: Número máximo de listas de tarefas a retornar
  - pageToken: Token de paginação para a próxima página

2. Criar uma Nova Tarefa

Use GOOGLETASKS_INSERT_TASK para adicionar uma nova tarefa a uma lista de tarefas específica.

Ferramenta: GOOGLETASKS_INSERT_TASK
Parâmetros:
  - tasklist_id (obrigatório): ID da lista de tarefas de destino
  - title (obrigatório): Título da tarefa
  - notes: Descrição/anotações da tarefa
  - due: Data de vencimento no formato RFC3339 (ex.: "2025-01-20T00:00:00.000Z")
  - status: "needsAction" ou "completed"
  - task_parent: ID da tarefa pai (para criar subtarefa)
  - task_previous: ID da tarefa anterior (para ordenação)

3. Listar Todas as Tarefas em Todas as Listas

Use GOOGLETASKS_LIST_ALL_TASKS para buscar tarefas em todas as listas de tarefas com filtros opcionais.

Ferramenta: GOOGLETASKS_LIST_ALL_TASKS
Parâmetros:
  - max_tasks_total: Número máximo total de tarefas a retornar
  - showCompleted: Incluir tarefas concluídas
  - showDeleted: Incluir tarefas excluídas
  - showHidden: Incluir tarefas ocultas
  - dueMin / dueMax: Filtrar por intervalo de data de vencimento
  - completedMin / completedMax: Filtrar por data de conclusão
  - updatedMin: Filtrar por hora da última atualização
  - showAssigned: Incluir tarefas atribuídas

4. Atualizar uma Tarefa Existente

Use GOOGLETASKS_UPDATE_TASK para modificar o título, anotações, data de vencimento ou status de uma tarefa.

Ferramenta: GOOGLETASKS_UPDATE_TASK
Parâmetros:
  - tasklist_id (obrigatório): ID da lista de tarefas
  - task_id (obrigatório): ID da tarefa a ser atualizada
  - title: Novo título
  - notes: Anotações atualizadas
  - due: Nova data de vencimento (RFC3339)
  - status: "needsAction" ou "completed"

5. Inserir Tarefas em Lote

Use GOOGLETASKS_BULK_INSERT_TASKS para criar várias tarefas de uma só vez em uma única operação.

Ferramenta: GOOGLETASKS_BULK_INSERT_TASKS
Parâmetros:
  - tasklist_id (obrigatório): ID da lista de tarefas de destino
  - tasks (obrigatório): Array de objetos de tarefa (cada um com title, notes, due, status)
  - batch_size: Número de tarefas por requisição em lote

6. Excluir ou Limpar Tarefas

Use GOOGLETASKS_DELETE_TASK para remover uma tarefa específica, ou GOOGLETASKS_CLEAR_TASKS para remover permanentemente todas as tarefas concluídas de uma lista.

Ferramenta: GOOGLETASKS_DELETE_TASK
Parâmetros:
  - tasklist_id (obrigatório): ID da lista de tarefas
  - task_id (obrigatório): ID da tarefa a ser excluída

Ferramenta: GOOGLETASKS_CLEAR_TASKS
Parâmetros:
  - tasklist (obrigatório): ID da lista de tarefas da qual limpar as concluídas

Padrões Comuns

• Obter o ID da lista de tarefas primeiro: Sempre comece com GOOGLETASKS_LIST_TASK_LISTS para descobrir as listas de tarefas disponíveis e seus IDs antes de criar ou listar tarefas.
• Listar depois atualizar: Use GOOGLETASKS_LIST_ALL_TASKS ou GOOGLETASKS_LIST_TASKS para encontrar IDs de tarefas, depois use GOOGLETASKS_UPDATE_TASK para modificá-las.
• Marcar como concluída: Atualize uma tarefa com status: "completed" usando GOOGLETASKS_UPDATE_TASK.
• Criar subtarefas: Use GOOGLETASKS_INSERT_TASK com o parâmetro task_parent definido como o ID da tarefa pai.
• Reordenar tarefas: Use GOOGLETASKS_MOVE_TASK para alterar a posição de uma tarefa dentro de sua lista ou alterar seu pai.
• Criação em lote: Use GOOGLETASKS_BULK_INSERT_TASKS para criar muitas tarefas de uma vez (ex.: importando de outro sistema).

Armadilhas Conhecidas

• Tanto tasklist_id quanto task_id são obrigatórios para GOOGLETASKS_UPDATE_TASK, GOOGLETASKS_DELETE_TASK e GOOGLETASKS_GET_TASK. Você não pode operar em uma tarefa sem saber a qual lista ela pertence.
• Todas as strings de data/hora devem estar no formato RFC3339 (ex.: 2025-01-20T00:00:00.000Z). Outros formatos serão rejeitados.
• GOOGLETASKS_CLEAR_TASKS exclui permanentemente todas as tarefas concluídas de uma lista. Esta ação é irreversível.
• GOOGLETASKS_LIST_ALL_TASKS busca em todas as listas, mas os resultados podem ser paginados — verifique os tokens de paginação.
• Os IDs das listas de tarefas não são os mesmos que os nomes das listas de tarefas. Sempre resolva nomes para IDs usando GOOGLETASKS_LIST_TASK_LISTS.
• A lista de tarefas padrão geralmente é chamada de "Minhas Tarefas", mas seu ID é uma string opaca, não "default" ou "primary".

Referência Rápida

Ação	Ferramenta	Parâmetros Principais
Listar listas de tarefas	GOOGLETASKS_LIST_TASK_LISTS	maxResults, pageToken
Listar todas as tarefas	GOOGLETASKS_LIST_ALL_TASKS	max_tasks_total, showCompleted, dueMin
Listar tarefas em uma lista	GOOGLETASKS_LIST_TASKS	tasklist_id, maxResults, showCompleted
Obter tarefa individual	GOOGLETASKS_GET_TASK	tasklist_id, task_id
Criar tarefa	GOOGLETASKS_INSERT_TASK	tasklist_id, title, notes, due
Criar tarefas em lote	GOOGLETASKS_BULK_INSERT_TASKS	tasklist_id, tasks
Atualizar tarefa	GOOGLETASKS_UPDATE_TASK	tasklist_id, task_id, title, status
Excluir tarefa	GOOGLETASKS_DELETE_TASK	tasklist_id, task_id
Mover/reordenar tarefa	GOOGLETASKS_MOVE_TASK	tasklist_id, task_id
Limpar concluídas	GOOGLETASKS_CLEAR_TASKS	tasklist

---

Desenvolvido por Composio