Skip to main content
Glama
housecallpro-mcp

housecallpro-mcp

by NoBanks

housecallpro-mcp

License: MIT Python MCP

MCP server for Housecall Pro, the mid-market trades vertical SaaS (HVAC, plumbing, electrical, garage, pest, landscaping). 5 tools for AI agents to register new customers, schedule jobs, create estimates, log inbound leads, and generate invoices (env-gated) against active jobs.

As of May 2026, Housecall Pro does not ship an official MCP server. Two low-visibility community attempts exist. This is the production-quality, install-ready Python rail.

The 5 tools

Tool

Purpose

Gated?

create_pro_customer

Register a new customer in the CRM

No, safe

schedule_new_job

Schedule a new trade job for an existing customer

No, safe

create_estimate

Generate a pricing estimate or proposal

No, safe

submit_new_lead

Log a new marketing or inbound prospect lead

No, safe

generate_job_invoice

Post an official invoice against an active job

YES, HOUSECALLPRO_ALLOW_INVOICE=true required

Related MCP server: ghl-mcp-server-v2

Install

pip install housecallpro-mcp

Configure

export HOUSECALLPRO_API_KEY="your-housecallpro-api-key"
export HOUSECALLPRO_ALLOW_INVOICE="false"   # set to "true" to enable invoice creation

Get an API key in your Housecall Pro account settings. The key is sent as a Bearer token; keep it server-side.

Use with Claude Desktop

{
  "mcpServers": {
    "housecallpro": {
      "command": "housecallpro-mcp",
      "env": {
        "HOUSECALLPRO_API_KEY": "your-housecallpro-api-key",
        "HOUSECALLPRO_ALLOW_INVOICE": "false"
      }
    }
  }
}

Restart Claude Desktop. The 5 Housecall Pro tools are now available.

Use case: AI receptionist + sales agent for a trades business

Typical agent flow for inbound calls and quotes:

  1. Call create_pro_customer(first_name, last_name, mobile_phone) to register the caller in CRM

  2. Call schedule_new_job(customer_id, description, start_time, end_time) to book the service window

  3. After the diagnostic call: create_estimate(customer_id, note) to propose pricing

  4. For web-form / chat inbound: submit_new_lead(customer_id, description) to log the prospect in the sales funnel

  5. (After job completion + with HOUSECALLPRO_ALLOW_INVOICE=true): generate_job_invoice(job_id) to bill the customer

Safety note

The invoice action is intentionally gated behind an explicit env var. The default install does not bill customers. Set HOUSECALLPRO_ALLOW_INVOICE="true" only when the AI agent workflow has been explicitly approved for billing actions.

Architecture

  • Public MIT-licensed wrapper around the Housecall Pro REST API

  • Async HTTP via httpx

  • pydantic v2 input validation

  • Bearer API key auth, server-side only

  • Rate-limit aware (429 returns a clean error)

  • Invoice action gated by env flag

Development

git clone https://github.com/NoBanks/housecallpro-mcp.git
cd housecallpro-mcp
pip install -e ".[dev]"
pytest

License

MIT. See LICENSE.

Author

Ryan Hammer (NoBanks). Solo founder + engineer. Built this and 14 other MCP servers as part of a sprint to expose AI agent rails for the products and platforms shipping daily.

Open to AI engineering roles, contract or full-time, remote-only.

Available Tools

5 tools
create_estimateA

Generate a pricing estimate or service proposal for a customer. Used by AI sales agents to quote work after diagnostic conversations.

Inputs: customer_id (required), note (required).

create_pro_customerA

Register a new customer in the Housecall Pro CRM. Used by AI receptionists to capture inbound caller details before scheduling a job.

Inputs: first_name (required), last_name (required), mobile_phone (required), email.

generate_job_invoiceA

Post an official invoice against an active job. GATED behind HOUSECALLPRO_ALLOW_INVOICE env var. Returns an error if not enabled. This action creates a billable customer-facing invoice.

Inputs: job_id (required).

schedule_new_jobB

Create and schedule a new trade job associated with an existing customer. Used by AI dispatchers to book service windows on the calendar.

Inputs: customer_id (required), description (required), start_time (required), end_time (required).

submit_new_leadA

Log a new marketing or inbound prospect lead in the Housecall Pro sales funnel. Used by AI agents handling inbound chat or web form submissions.

Inputs: customer_id (required), description (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct business function (estimate, customer, invoice, job, lead) with no overlapping purposes, ensuring clear differentiation for an agent.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (create_, generate_, schedule_, submit_), making the surface predictable and easy to navigate.

    Tool Count5/5

    With 5 tools, the server covers core CRM workflows without being bloated or sparse—appropriate for a focused home service management integration.

    Completeness4/5

    The tools cover essential actions (create, schedule, invoice, lead) but lack update/delete operations or search, leaving minor gaps for advanced workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A remote MCP server that exposes the ServiceTitan API as tools, enabling Claude and other clients to manage customers, jobs, pricebook, invoicing, and more with write safety and built-in observability.
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      A comprehensive MCP server covering the full GoHighLevel API surface with 651 tools, enabling management of contacts, opportunities, calendars, invoices, and more through natural language, with multi-tenant support and read-only safety defaults.
      500
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A local MCP server that wraps the Housecall Pro Public API, enabling Claude to read and write Housecall Pro data (customers, jobs, estimates, invoices, etc.) via natural language.
      23
      -