Automação do Harvest

Automatize suas operações de registro de tempo do Harvest diretamente do Claude Code. Registre entradas de tempo, gerencie projetos e clientes, crie tarefas e extraia dados de relatórios – tudo sem sair do seu terminal.

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

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 do Harvest através do link de conexão fornecido
3. Comece a automatizar seus fluxos de trabalho de registro de tempo com linguagem natural

Fluxos de Trabalho Principais

1. Registrar e Gerenciar Entradas de Tempo

Crie, liste, atualize e recupere entradas de tempo para faturamento e relatórios precisos.

Ferramentas: HARVEST_CREATE_TIME_ENTRY, HARVEST_LIST_TIME_ENTRIES, HARVEST_GET_TIME_ENTRY, HARVEST_UPDATE_TIME_ENTRY

Log 3.5 hours of development work on project 12345, task 67890 for today

Parâmetros chave para HARVEST_CREATE_TIME_ENTRY:

• project_id (obrigatório) -- o projeto para registrar
• task_id (obrigatório) -- a tarefa deve ser atribuída ao projeto
• spent_date (obrigatório) -- data no formato YYYY-MM-DD
• hours -- total de horas (para contas baseadas em duração)
• started_time / ended_time -- para contas baseadas em timestamp
• notes -- descrição do trabalho realizado

Parâmetros chave para HARVEST_LIST_TIME_ENTRIES:

• from_date / to -- filtros de intervalo de datas (YYYY-MM-DD)
• project_id, client_id, task_id, user_id -- filtros de entidade
• is_billed / is_running -- filtros de status
• page / per_page (máx. 2000) -- paginação

2. Gerenciar Projetos

Crie novos projetos e liste os existentes com configuração de cliente e faturamento.

Ferramentas: HARVEST_CREATE_PROJECT, HARVEST_LIST_PROJECTS, HARVEST_GET_PROJECT

Create a billable project called "Website Redesign" for client 456 with Tasks billing and project budget

Parâmetros chave para HARVEST_CREATE_PROJECT:

• name, client_id, is_billable, bill_by, budget_by (todos obrigatórios)
• Opções de bill_by: "Project", "Tasks", "People", "none"
• Opções de budget_by: "project", "project_cost", "task", "task_fees", "person", "none"
• Opcional: budget, hourly_rate, starts_on, ends_on, is_fixed_fee

3. Gerenciar Clientes

Crie e liste clientes sob os quais os projetos são organizados.

Ferramentas: HARVEST_CREATE_CLIENT, HARVEST_LIST_CLIENTS

List all active clients in our Harvest account

• HARVEST_CREATE_CLIENT requer name; aceita address, currency, is_active
• HARVEST_LIST_CLIENTS suporta filtro is_active e paginação (per_page máx. 2000)

4. Gerenciar Tarefas

Crie e liste tipos de tarefas reutilizáveis para registro de tempo.

Ferramentas: HARVEST_CREATE_TASK, HARVEST_LIST_TASKS

Create a new billable task called "Code Review" with a default rate of $150/hr

• HARVEST_CREATE_TASK requer name; aceita billable_by_default, default_hourly_rate, is_active, is_default
• HARVEST_LIST_TASKS suporta filtros is_active, is_default e paginação (per_page máx. 100)
• Nomes de tarefas devem ser únicos entre todas as tarefas (ativas e arquivadas)

5. Relatórios de Entrada de Tempo

Extraia entradas de tempo com intervalos de datas e filtros para resumos de faturamento e relatórios de utilização.

Ferramentas: HARVEST_LIST_TIME_ENTRIES, HARVEST_GET_TIME_ENTRY

Show me all unbilled time entries for project 789 from January 2026

• Use from_date e to para janelas de datas
• Filtre com is_billed: false para entradas não faturadas
• Combine project_id, user_id, client_id para relatórios multidimensionais
• Paginação com page e per_page para coletar conjuntos de dados completos

6. Atualizar e Corrigir Entradas de Tempo

Modifique entradas de tempo existentes para corrigir horas, reatribuir projetos ou atualizar notas.

Ferramentas: HARVEST_UPDATE_TIME_ENTRY

Update time entry 123456 to change the hours to 4.0 and add the note "Completed API integration"

• Requer time_entry_id
• Suporta atualizações parciais -- inclua apenas os campos que você deseja alterar
• Pode atualizar hours, notes, project_id, task_id, spent_date, started_time, ended_time

Armadilhas Conhecidas

• Atribuição de tarefa é importante: Ao criar entradas de tempo, a task_id deve corresponder a uma tarefa que está realmente atribuída ao project_id especificado. Use o endpoint de atribuições de tarefas do projeto para verificar, não apenas HARVEST_LIST_TASKS (que retorna tarefas globais).

…