housecallpro-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@housecallpro-mcp Register a new customer named Alice Johnson with phone 555-9876"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
housecallpro-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? |
| Register a new customer in the CRM | No, safe |
| Schedule a new trade job for an existing customer | No, safe |
| Generate a pricing estimate or proposal | No, safe |
| Log a new marketing or inbound prospect lead | No, safe |
| Post an official invoice against an active job | YES, |
Related MCP server: ghl-mcp-server-v2
Install
pip install housecallpro-mcpConfigure
export HOUSECALLPRO_API_KEY="your-housecallpro-api-key"
export HOUSECALLPRO_ALLOW_INVOICE="false" # set to "true" to enable invoice creationGet 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:
Call
create_pro_customer(first_name, last_name, mobile_phone)to register the caller in CRMCall
schedule_new_job(customer_id, description, start_time, end_time)to book the service windowAfter the diagnostic call:
create_estimate(customer_id, note)to propose pricingFor web-form / chat inbound:
submit_new_lead(customer_id, description)to log the prospect in the sales funnel(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
httpxpydantic 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]"
pytestLicense
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.
GitHub: @NoBanks
X/Twitter: @livingagentic
Open to AI engineering roles, contract or full-time, remote-only.
Available Tools
5 toolscreate_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
Scored across 5 tools
Each tool targets a distinct business function (estimate, customer, invoice, job, lead) with no overlapping purposes, ensuring clear differentiation for an agent.
All tools follow a consistent verb_noun pattern (create_, generate_, schedule_, submit_), making the surface predictable and easy to navigate.
With 5 tools, the server covers core CRM workflows without being bloated or sparse—appropriate for a focused home service management integration.
The tools cover essential actions (create, schedule, invoice, lead) but lack update/delete operations or search, leaving minor gaps for advanced workflows.
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA 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
- AlicenseCqualityBmaintenanceA 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.5001MIT
- AlicenseAqualityDmaintenanceMCP server that lets you talk to your GoHighLevel sub-account in plain English, offering six tools to search contacts, list calendars, check free slots, and book appointments with dry-run safety and explicit error messages.6MIT
- FlicenseAqualityDmaintenanceA 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-