Hawk Field Services Plugin for Claude Desktop

Connect your Hawk field service operations to Claude Desktop. Manage work orders, dispatch technicians, log time and materials, and track job profitability — all from a Claude conversation.

Built for HVAC, plumbing, electrical, and other field service businesses.

What you can do

• Work orders — create, list, get details, update status
• Dispatch — schedule jobs, view today's board by technician
• Time tracking — log billable and non-billable hours per work order
• Materials — log parts used with markup, get running job cost
• Job costing — see labor + materials breakdown and gross margin
• Preventive maintenance — list upcoming PM agreements due within N days

Requirements

• A Hawk account at hawk.business with the Field Services plugin enabled
• Claude Desktop (Mac or Windows)
• Node.js 20.18.1 or later

Install

1. Get your API key

In your Hawk dashboard go to Settings → Integrations → Claude Desktop Plugin, select the Field Services tab, and copy your Channel API Key.

2. Add to Claude Desktop config

Open ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

{
  "mcpServers": {
    "hawk-field-services": {
      "command": "npx",
      "args": ["-y", "@buzzie-ai/hawk-field-services"],
      "env": {
        "HAWK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with the key from Step 1.

Tip: Your Hawk dashboard shows a pre-filled config snippet with your API key already inserted.

3. Restart Claude Desktop

The hawk-field-services tools will appear in the tool list. Try:

• "Create a work order for a furnace repair at 123 Main St"
• "Schedule tech John for WO-1042 tomorrow at 9am"
• "Log 3 hours on WO-1042 at $85/hr"
• "What's the job cost on WO-1042?"

Tools

Tool	Description
create_work_order	Create a new service call or job
list_work_orders	List work orders with status/customer filters
get_work_order	Get full details including time, materials, and cost
update_work_order_status	Update status (scheduled → in-progress → complete)
schedule_job	Assign a technician and time window to a work order
get_schedule	View the dispatch board for a date and/or technician
log_time	Record labor hours on a work order
log_materials	Log parts used with unit cost and markup
get_job_cost	Get labor + materials breakdown and gross margin
list_upcoming_pms	List preventive maintenance agreements due soon
ask_hawk	Ask a question about your field service data

Support

Open an issue in this repo or contact support via your Hawk dashboard.