usefulapi

Housecall Pro MCP server. Manage Housecall Pro customers, jobs, estimates and leads; schedule and dispatch jobs.

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://housecall-pro.usefulapi.io/mcp
Authenticate with Housecall Pro when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "housecall-pro": {
      "url": "https://housecall-pro.usefulapi.io/mcp"
    }
  }
}

live27 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 27

Tool	Type	What it does
`housecall_get_company`	read	Get the company Fetch the Housecall Pro company this key belongs to — name, contact details, address, time zone, service-area zip codes and (multi-location) its locations. A cheap way to confirm the key works. Housecall Pro: GET /company.
`housecall_list_customers`	read	List customers List or search customers, with their phone numbers, tags and addresses. `q` searches name, email, mobile number and address. Housecall Pro: GET /customers.
`housecall_get_customer`	read	Get one customer Fetch a single customer by id, including their addresses (whose ids you need to create a job or estimate). Housecall Pro: GET /customers/{customer_id}.
`housecall_list_jobs`	read	List jobs List jobs, filterable by scheduled window, customer, assigned employees and work status. Each job carries its customer, address, notes, schedule, assigned employees and totals. Housecall Pro: GET /jobs.
`housecall_get_job`	read	Get one job Fetch a single job by id — customer, address, work status and timestamps, schedule, assigned employees, notes and totals. Housecall Pro: GET /jobs/{id}.
`housecall_list_job_line_items`	read	List a job's line items List the line items (services, materials, labor, discounts) on one job, with unit price, cost, quantity and amount in cents. Housecall Pro: GET /jobs/{job_id}/line_items.
`housecall_list_job_invoices`	read	List a job's invoices List the invoices raised for one job, with status, amounts, due and paid dates, items, taxes, discounts and payments. Housecall Pro: GET /jobs/{job_id}/invoices.
`housecall_list_invoices`	read	List invoices List invoices across the company, filterable by status, customer, and created / due / paid date ranges — e.g. everything open and overdue. Amounts are in cents. Housecall Pro: GET /invoices.
`housecall_list_estimates`	read	List estimates List estimates, filterable by scheduled window, customer, assigned employees and work status. Each carries its customer, address, schedule and options. Housecall Pro: GET /estimates.
`housecall_get_estimate`	read	Get one estimate Fetch a single estimate by id, including its options and each option's approval status. Housecall Pro: GET /estimates/{estimate_id}.
`housecall_list_employees`	read	List employees List the company's active employees with their role, contact details and permissions. Use their ids to assign or dispatch jobs. Housecall Pro: GET /employees.
`housecall_list_leads`	read	List leads List leads, filterable by status (open / won / lost), customer, assigned employees, tags and lead source. Housecall Pro: GET /leads.
`housecall_get_lead`	read	Get one lead Fetch a single lead by id — its customer, address, lead source, tags, assigned employee, status and pipeline status. Housecall Pro: GET /leads/{id}.
`housecall_list_job_types`	read	List job types List the company's job types (e.g. Repair, Install, Maintenance). Use an id as job_type_id when creating a job or estimate. Housecall Pro: GET /job_fields/job_types.
`housecall_list_tags`	read	List tags List the tags defined in the company. Housecall Pro: GET /tags.
`housecall_list_price_book_services`	read	List price book services List or search the price book's services — name, task number, price and cost (cents), taxable and online-booking flags; optionally with their materials and labor rates. Housecall Pro: GET /api/price_book/services.
`housecall_create_customer`	write	Create a customer Create a new customer, optionally with one or more addresses. Housecall Pro: POST /customers.
`housecall_update_customer`	write	Update a customer Change a customer's name, contact details, tags, lead source, notes or notification setting. Only the fields you pass are sent. Housecall Pro: PUT /customers/{customer_id}.
`housecall_create_customer_address`	write	Add an address to a customer Add a service address to an existing customer. Returns the address id to use when creating a job or estimate. Housecall Pro: POST /customers/{customer_id}/addresses.
`housecall_create_job`	write	Create a job Create a job for an existing customer at one of their existing addresses, optionally scheduled, assigned, tagged and with line items (prices in cents). Get address ids from housecall_get_customer. Housecall Pro: POST /jobs.
`housecall_update_job_schedule`	write	Reschedule a job Set or change a job's scheduled start/end and arrival window, optionally dispatching employees and notifying the customer and/or the pro. Jobs with more than one appointment (multi-day) cannot be rescheduled here. Housecall Pro: PUT /jobs/{job_id}/schedule.
`housecall_dispatch_job`	write	Dispatch a job to employees Set which employees a job is dispatched to. This REPLACES the current dispatch list — pass everyone who should be on the job. Housecall Pro: PUT /jobs/{job_id}/dispatch.
`housecall_add_job_note`	write	Add a note to a job Add a text note to a job. Housecall Pro: POST /jobs/{job_id}/notes.
`housecall_create_estimate`	write	Create an estimate Create an estimate for a customer with one or more options (e.g. Good / Better / Best), each with line items priced in cents. Give an existing address_id or a new address. Housecall Pro: POST /estimates.
`housecall_create_lead`	write	Create a lead Create a lead, either for an existing customer (customer_id) or with a new customer inline (customer). Optionally with an address, lead source, assigned employee, tags, note and line items priced in cents. Housecall Pro: POST /leads.
`housecall_usage_status`	meta	Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter.
`housecall_upgrade`	meta	Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Housecall Pro tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Proper user	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.