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.