Automação do Toggl

Automatize suas operações de rastreamento de tempo do Toggl Track diretamente do Claude Code. Registre tempo, gerencie projetos e clientes, organize com tags e controle espaços de trabalho – tudo sem sair do seu terminal.

Documentação do Toolkit: composio.dev/toolkits/toggl

Configuração

1. Adicione o servidor Rube MCP à sua configuração do Claude Code com o URL: https://rube.app/mcp
2. Quando solicitado, autentique sua conta Toggl Track através do link de conexão fornecido
3. Comece a automatizar seus fluxos de trabalho de rastreamento de tempo com linguagem natural

Fluxos de Trabalho Principais

1. Criar e Parar Lançamentos de Tempo

Registre tempo com associações de projeto, tarefa e tag, ou inicie/pare cronômetros.

Ferramentas: TOGGL_CREATE_TIME_ENTRY, TOGGL_PATCH_STOP_TIME_ENTRY

Start a time entry in workspace 123456 for project 78910 tagged "meeting" and "design" with description "Design review session"

Parâmetros chave para TOGGL_CREATE_TIME_ENTRY:

• workspace_id (obrigatório) -- espaço de trabalho de destino
• created_with (obrigatório) -- nome do aplicativo cliente (ex: "api_client")
• start (obrigatório) -- timestamp ISO 8601
• stop -- hora de término ISO 8601; omita para deixar o lançamento em execução
• duration -- duração em segundos; omita para lançamentos em execução
• project_id -- associar com um projeto
• task_id -- associar com uma tarefa
• tags -- array de strings de nomes de tags (não IDs)
• description -- descrição do trabalho
• billable -- status de faturamento

Parâmetros chave para TOGGL_PATCH_STOP_TIME_ENTRY:

• workspace_id (obrigatório) e time_entry_id (obrigatório)

2. Gerenciar Projetos

Crie novos projetos e liste os existentes com detalhes do cliente e paginação.

Ferramentas: TOGGL_CREATE_PROJECT, TOGGL_GET_PROJECTS, TOGGL_GET_PROJECT_DETAILS

Create a private billable project called "Q1 Marketing Campaign" in workspace 123456 for client 78910

Parâmetros chave para TOGGL_CREATE_PROJECT:

• workspace_id (obrigatório) e name (obrigatório)
• client_id, billable, is_private, active, color
• estimated_hours, rate, fixed_fee, currency (recursos premium)

Parâmetros chave para TOGGL_GET_PROJECTS:

• workspace_id (obrigatório)
• page / page_size (1-200) para paginação
• since / until -- timestamps Unix para filtragem de modificação (apenas últimos 3 meses)
• clients: true para incluir detalhes completos do cliente

3. Gerenciar Clientes

Crie e liste clientes dentro de um espaço de trabalho.

Ferramentas: TOGGL_CREATE_CLIENT, TOGGL_GET_LIST_CLIENTS

List all active clients in workspace 123456, then create a new client called "Acme Corp"

• TOGGL_CREATE_CLIENT requer workspace_id e name; aceita notes, external_reference
• TOGGL_GET_LIST_CLIENTS requer workspace_id; suporta status ("active", "archived", "both") e name (busca case-insensitive)

4. Tags e Preferências do Espaço de Trabalho

Recupere tags para categorização e verifique as configurações do espaço de trabalho.

Ferramentas: TOGGL_GET_TAGS, TOGGL_GET_WORKSPACE_PREFERENCES

Show me all tags in workspace 123456 and the workspace preferences

• TOGGL_GET_TAGS requer workspace_id; retorna IDs e nomes de tags
• TOGGL_GET_WORKSPACE_PREFERENCES requer workspace_id; retorna plano de preços e configurações de exibição

5. Descoberta de Espaço de Trabalho

Liste todos os espaços de trabalho aos quais o usuário autenticado pertence.

Ferramenta: TOGGL_GET_USER_WORKSPACES

What Toggl workspaces do I have access to?

• Nenhum parâmetro necessário
• Retorna todos os espaços de trabalho com IDs, nomes e metadados
• Use isso primeiro para descobrir IDs de espaço de trabalho para outras operações

6. Visibilidade de Projetos do Usuário

Liste projetos visíveis para o usuário autenticado.

Ferramenta: TOGGL_GET_USER_PROJECTS

Show me all projects I can see across my workspaces

• Retorna projetos aos quais o usuário autenticado tem acesso
• Use em conjunto com TOGGL_GET_PROJECTS para visualizações com escopo de espaço de trabalho

Armadilhas Conhecidas

• Tags usam nomes, não IDs: TOGGL_CREATE_TIME_ENTRY aceita nomes de tags como strings no array tags, ao contrário de muitas APIs que usam IDs. Use TOGGL_GET_TAGS para verificar os nomes de tags disponíveis.
• created_with é obrigatório: Cada lançamento de tempo deve incluir created_with (ex: "api_client"). A falta deste campo causa falhas silenciosas.
• Duração em segundos: O parâmetro duration em lançamentos de tempo é em segundos, não em horas. 1 hora = 3600 segundos.
• Restrição de timestamp since: O filtro since em TOGGL_GET_PROJECTS permite apenas timestamps dentro dos últimos 3 meses. Consultas mais antigas serão rejeitadas.

…