Harvest

Manage time tracking, projects, and invoicing from chat -- log time entries, create invoices and estimates, manage clients and projects, record expenses, and administer team members. Powered by ClawLink for hosted OAuth.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect Harvest
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect Harvest

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  Harvest API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

// 1. List your time entries
clawlink_call_tool({ tool: "harvest_list_time_entries", parameters: {} })

// 2. Log a new time entry
clawlink_call_tool({ tool: "harvest_create_time_entry", parameters: { project_id: "123", task_id: "456", hours: 2.5 } })

// 3. List projects
clawlink_call_tool({ tool: "harvest_list_projects", parameters: {} })

Authentication

ClawLink handles OAuth with Harvest. No API keys needed. Connect at claw-link.dev/dashboard?add=harvest.

Connection Management

// List connections
clawlink_list_integrations()

// Verify by getting company info
clawlink_call_tool({ tool: "harvest_get_company_info", parameters: {} })

Security & Permissions

• Read tools are safe and require no confirmation
• Write tools require confirmation before execution
• Delete operations are high-impact and irreversible
• Admin or Manager permissions required for many write operations

Tool Reference

Time Tracking Operations

Project Operations

Client Operations

Invoice Operations

Estimate Operations

Expense Operations

Task Operations

User & Company Operations

Code Examples

Example 1: Time tracking workflow

// Log time to a project
await clawlink_call_tool({
  tool: "harvest_create_time_entry",
  parameters: {
    project_id: "123456",
    task_id: "789012",
    date: "2026-06-08",
    hours: 3.5,
    notes: "API integration work"
  }
});

// List today's time entries
const entries = await clawlink_call_tool({
  tool: "harvest_list_time_entries",
  parameters: { from: "2026-06-08", to: "2026-06-08" }
});

Example 2: Create and send an invoice

// Create an invoice
const invoice = await clawlink_call_tool({
  tool: "harvest_create_invoice",
  parameters: {
    client_id: "5735776",
    line_items: [{
      project_id: "123456",
      kind: "hours",
      quantity: 10,
      unit_price: 150
    }]
  }
});

// Send the invoice
await clawlink_call_tool({
  tool: "harvest_create_invoice_message",
  parameters: {
    invoice_id: invoice.id,
    event_type: "send"
  }
});

Example 3: Project and expense management

// Create a project
const project = await clawlink_call_tool({
  tool: "harvest_create_project",
  parameters: {
    client_id: "5735776",
    name: "Website Redesign",
    is_billable: true,
    bill_by: "Project",
    budget_by: "project",
    budget: 100
  }
});

// Record an expense
await clawlink_call_tool({
  tool: "harvest_create_expense",
  parameters: {
    project_id: project.id,
    expense_category_id: "456",
    date: "2026-06-08",
    total_cost: 250.00,
    notes: "Software license"
  }
});

Discovery Workflow

1. Call clawlink_list_integrations to confirm harvest is connected.
2. Call clawlink_list_tools --integration harvest to see the live catalog.
3. Use clawlink_search_tools({ query: "invoice", integration: "harvest" }) to find specific tools.

Execution Workflow

READ (safe):     list_time_entries → list_projects → list_invoices → get_company_info
WRITE (confirm): create_time_entry → create_invoice → create_project → update_client
DELETE (high):   delete_project → delete_invoice → delete_time_entry → delete_user

Notes

• Projects require a valid client_id -- use list_clients first
• Invoice item categories cannot be deleted if actively used for billing
• Large project lists may return remote files instead of inline JSON
• Company settings (timezone, currency) cannot be changed via API

Error Handling

Troubleshooting

Tools Not Visible

• Start a fresh OpenClaw chat to reload plugin catalog
• Call clawlink_list_integrations to confirm pairing

Cannot Create Project

• Ensure client_id exists by calling list_clients
• Verify billing configuration fields (bill_by, budget_by)

Resources

• Harvest API Docs: https://help.getharvest.com/api-v2/
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=harvest
• ClawLink Docs: https://docs.claw-link.dev/openclaw

Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=harvest) -- an integration hub for OpenClaw