Automação do Clockify

Automatize suas operações de rastreamento de tempo do Clockify diretamente do Claude Code. Registre entradas de tempo, consulte dados históricos, gerencie espaços de trabalho e audite a atividade da equipe – tudo sem sair do seu terminal.

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

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 Clockify 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 Entradas de Tempo

Registre o tempo com associações de projeto, tarefa e tag, além do status de faturamento.

Ferramenta: CLOCKIFY_CREATE_TIME_ENTRY

Log 2 hours of work on project 64a687e2 in workspace 64a687e3 starting at 9am UTC today with description "API development"

Parâmetros principais:

• workspaceId (obrigatório) -- espaço de trabalho onde a entrada é criada
• start (obrigatório) -- hora de início no formato ISO 8601 (ex: 2026-02-11T09:00:00Z)
• end -- hora de término no formato ISO 8601; omita para criar um cronômetro em execução
• projectId -- associar a um projeto
• taskId -- associar a uma tarefa
• description -- descrição do trabalho (0-3000 caracteres)
• tagIds -- array de IDs de tags
• billable -- se a entrada é faturável
• customFieldValues -- array de entradas de campos personalizados com customFieldId e value

2. Consultar Entradas de Tempo

Recupere entradas de tempo históricas para relatórios, auditorias e faturamento.

Ferramenta: CLOCKIFY_GET_TIME_ENTRIES

Get all time entries for user abc123 in workspace xyz789 from January 2026

Parâmetros principais:

• workspaceId (obrigatório) -- espaço de trabalho para consultar
• userId (obrigatório) -- usuário cujas entradas recuperar
• start / end -- filtros de intervalo de datas ISO 8601
• project -- filtrar por ID de projeto
• task -- filtrar por ID de tarefa
• tags -- IDs de tags separados por vírgula
• description -- filtro de texto (correspondência parcial)
• hydrated -- defina true para obter objetos completos de projeto/tarefa/tag em vez de apenas IDs
• in-progress -- defina true para retornar apenas o cronômetro em execução
• page / page-size -- paginação (padrão 50 por página)

3. Excluir Entradas de Tempo

Remova entradas de tempo errôneas, duplicadas ou canceladas.

Ferramenta: CLOCKIFY_DELETE_TIME_ENTRY

Delete time entry 5b715448 from workspace 64a687e3

• Requer workspaceId e id (o ID da entrada de tempo)
• Use para limpeza de importações incorretas ou duplicatas

4. Gerenciar Espaços de Trabalho

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

Ferramenta: CLOCKIFY_GET_ALL_MY_WORKSPACES

Show me all my Clockify workspaces

• Filtro opcional roles -- array de funções como ["WORKSPACE_ADMIN", "OWNER"]
• Use isso para descobrir IDs de espaço de trabalho antes de criar ou consultar entradas

5. Informações do Usuário

Recupere detalhes do usuário atual e liste membros do espaço de trabalho.

Ferramentas: CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO, CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE

Who am I logged in as? Then list all users in workspace 64a687e3

• CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO retorna o perfil do usuário autenticado (nenhum parâmetro necessário)
• CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE requer workspaceId; suporta filtros name, email e paginação (page, page-size máximo 100)

6. Gerenciamento de Cronômetro em Execução

Inicie um cronômetro omitindo end na criação, ou verifique entradas em execução.

Ferramentas: CLOCKIFY_CREATE_TIME_ENTRY, CLOCKIFY_GET_TIME_ENTRIES

Start a timer on project abc in workspace xyz with description "Working on bug fix"

• Crie sem end para iniciar um cronômetro em execução
• Use CLOCKIFY_GET_TIME_ENTRIES com in-progress: true para verificar se um cronômetro está em execução

Armadilhas Conhecidas

• IDs de espaço de trabalho e usuário são obrigatórios: A maioria das ferramentas do Clockify requer tanto workspaceId quanto userId. Sempre chame CLOCKIFY_GET_ALL_MY_WORKSPACES e CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO primeiro para resolver esses IDs.
• Timestamps ISO 8601: Todos os parâmetros de tempo devem estar no formato ISO 8601 com fuso horário (ex: 2026-02-11T09:00:00Z). Omitir o fuso horário causa comportamento imprevisível.
• Cronômetros em execução: Apenas um cronômetro pode ser executado por vez. Criar uma nova entrada sem end falhará se outro cronômetro já estiver ativo. Pare o cronômetro existente primeiro.
• Padrões de paginação: CLOCKIFY_GET_TIME_ENTRIES tem um padrão de 50 entradas por página. Para exportações completas, itere pelas páginas até que nenhum outro resultado seja retornado.

…