ComposioHQ/Clockify-Automation

Automação Clockify

Automatize suas operações de registro de horas no 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 terminal.

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

---

Configuração

1. Adicione o servidor MCP Rube à configuração do seu Claude Code com a 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 registro de horas com comandos em linguagem natural

---

Fluxos Principais

1. Criar Entradas de Tempo

Registre tempo com associações a projeto, tarefa e tags, além do status faturável.

Ferramenta: CLOCKIFY_CREATE_TIME_ENTRY

Registre 2 horas de trabalho no projeto 64a687e2 no workspace 64a687e3 começando às 9:00 UTC hoje com a descrição "Desenvolvimento de API"

Parâmetros principais:

• workspaceId (obrigatório) — workspace onde a entrada é criada
• start (obrigatório) — horário de início no formato ISO 8601 (ex.: 2026-02-11T09:00:00Z)
• end — horário de término no formato ISO 8601; omita para criar um timer 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 campo personalizado com customFieldId e value

2. Consultar Entradas de Tempo

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

Ferramenta: CLOCKIFY_GET_TIME_ENTRIES

Obtenha todas as entradas de tempo do usuário abc123 no workspace xyz789 de janeiro de 2026

Parâmetros principais:

• workspaceId (obrigatório) — workspace a consultar
• userId (obrigatório) — usuário cujas entradas serão recuperadas
• start / end — filtros de intervalo de datas no formato ISO 8601
• project — filtrar por ID do projeto
• task — filtrar por ID da tarefa
• tags — IDs de tags separados por vírgula
• description — filtro de texto (correspondência parcial)
• hydrated — defina como true para obter objetos completos de projeto/tarefa/tag em vez de apenas IDs
• in-progress — defina como true para retornar apenas o timer 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

Exclua a entrada de tempo 5b715448 do 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

Mostre todos os meus espaços de trabalho do Clockify

• Filtro opcional roles — array de funções como ["WORKSPACE_ADMIN", "OWNER"]
• Use para descobrir IDs de workspace 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

Quem sou eu? Depois, liste todos os usuários no 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 Timer em Execução

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

Ferramentas: CLOCKIFY_CREATE_TIME_ENTRY, CLOCKIFY_GET_TIME_ENTRIES

Inicie um timer no projeto abc no workspace xyz com a descrição "Trabalhando na correção de bug"

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

---

Armadilhas Conhecidas

• IDs de workspace 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.
• Timers em execução: Apenas um timer pode ser executado por vez. Criar uma nova entrada sem end falhará se outro timer já estiver ativo. Pare o timer existente primeiro.
• Paginação padrão: CLOCKIFY_GET_TIME_ENTRIES padrão é de 50 entradas por página. Para exportações completas, percorra as páginas até não haver mais resultados.
• IDs de tags têm escopo por workspace: IDs de tags de um workspace não podem ser usados em outro. Sempre resolva as tags dentro do contexto do workspace de destino.

---

Referência Rápida

Slug da Ferramenta	Descrição
CLOCKIFY_CREATE_TIME_ENTRY	Cria uma entrada de tempo ou inicia um timer (requer workspaceId, start)
CLOCKIFY_GET_TIME_ENTRIES	Lista entradas de tempo com filtros (requer workspaceId, userId)
CLOCKIFY_DELETE_TIME_ENTRY	Exclui uma entrada de tempo (requer workspaceId, id)
CLOCKIFY_GET_ALL_MY_WORKSPACES	Lista todos os espaços de trabalho do usuário autenticado
CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO	Obtém informações do perfil do usuário atual
CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE	Lista todos os usuários em um espaço de trabalho (requer workspaceId)

---

Desenvolvido por Composio