Housecall Pro MCP
Open-source Housecall Pro API server for jobs, estimates, invoices and the price book
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 1.19.0
- Listing updated
- 2 days ago
About Housecall Pro MCP
Housecall Pro MCP is an open-source MCP server for home services. It runs locally on your machine and is started by your AI client.
The author runs a service company on Housecall Pro and built this because the API gives wrong answers in quiet ways. The README tabulates the quirks: money arrives as integer cents so a $250 job is 25000, PATCH on a job returns 200 and changes nothing for some fields, invoice date filters are accepted and ignored, and deleted jobs still count toward totals. The server converts currency both ways, normalises status words, filters dates client-side and exposes the deleted marker on every row.
It does not retry failed writes, since a repeated write can create a duplicate, while reads do retry. Environment variables let you register fewer tools: HCP_READ_ONLY=1 removes anything that can change data, and HCP_TOOLSETS selects groups such as customers, jobs, estimates, invoices, pricebook, schedule, reports or admin.
It is described as independent and not affiliated with Housecall Pro. Running it needs Node 18 and an API key, which requires the MAX plan and an admin login.
Install
Run in a terminal
claude mcp add housecall-pro-mcp --env HCP_API_KEY='<HCP_API_KEY>' -- npx -y housecall-pro-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"housecall-pro-mcp": {
"command": "npx",
"args": [
"-y",
"housecall-pro-mcp"
],
"env": {
"HCP_API_KEY": "<HCP_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"housecall-pro-mcp": {
"command": "npx",
"args": [
"-y",
"housecall-pro-mcp"
],
"env": {
"HCP_API_KEY": "<HCP_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"housecall-pro-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"housecall-pro-mcp"
],
"env": {
"HCP_API_KEY": "<HCP_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"housecall-pro-mcp": {
"command": "npx",
"args": [
"-y",
"housecall-pro-mcp"
],
"env": {
"HCP_API_KEY": "<HCP_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"housecall-pro-mcp": {
"command": "npx",
"args": [
"-y",
"housecall-pro-mcp"
],
"env": {
"HCP_API_KEY": "<HCP_API_KEY>"
}
}
}
}Configuration
HCP_API_KEYA Housecall Pro API key. Generated under My Apps, Go to App store, API Key Management. Requires their MAX plan and an admin login.RequiredHCP_READ_ONLYSet to 1 to register no tool that can change anything in Housecall Pro.HCP_TOOLSETSComma-separated groups to register: company, customers, jobs, estimates, invoices, pricebook, schedule, reports, admin. Also 'all' and 'default'. Fewer tools in context makes a client choose better among them.HCP_TOOLSComma-separated tool names to register in addition to the toolsets, e.g. hcp_list_jobs. Pair with HCP_TOOLSETS=none for exactly these tools. An unknown name stops the server rather than silently registering nothing.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- hcp_list_jobs
- List jobs in the Housecall Pro account
What it does
- Cent-to-dollar conversion
- Reads return dollars and writes take dollars, avoiding a hundredfold billing error.
- Read-only switch
- HCP_READ_ONLY=1 registers no tool that can change account data.
- Toolset selection
- Load only groups such as jobs, invoices or the price book.
- Status normalisation
- Filters on completed work match the vocabulary the API returns.
- Deleted-job warnings
- Each job row shows its deleted marker so revenue is not overstated.
- No blind write retries
- Failed writes are not retried, so duplicates are not created.
Good for
- Ask which jobs were completed this month without counting deleted ones
- Draft an estimate or invoice from a chat
- Check the schedule for a technician
- Look up price book items
- Run a read-only review of customers and jobs
Pricing
Open source
Free; the Housecall Pro API needs the MAX plan
Prices change. Check hcpapi.com before you buy.
Housecall Pro MCP FAQ
What do I need to use it?
Node 18 or newer and a Housecall Pro API key, which comes with the MAX plan.
Is it made by Housecall Pro?
No. The README says it is independent and not affiliated with or endorsed by Housecall Pro.
How do I keep it from changing data?
Set HCP_READ_ONLY=1.
Does it cost anything?
The site says it is free forever; your Housecall Pro plan still applies.
Is Housecall Pro MCP free?
Yes. Housecall Pro MCP is open source, so you can use and self-host it for free.
How do I add Housecall Pro MCP to Claude Code?
Run this command in your terminal: claude mcp add housecall-pro-mcp --env HCP_API_KEY='<HCP_API_KEY>' -- npx -y housecall-pro-mcp
What are the best alternatives to Housecall Pro MCP?
The closest alternatives to Housecall Pro MCP are MadMax Trade Supply parts, Host Tools, HALPII, Spark Pack and Nero Work.
Alternatives to Housecall Pro MCP

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce
Host Tools
MCP serverAirbnb, VRBO and Booking.com messages, reservations, reviews and pricing via API
- Remote
- Free trial
- Home services

HALPII
MCP serverFind tradespeople across Latin America by trade and city from an AI assistant
- 4 tools
- Remote
- Free
- Home services
Spark Pack
MCP serverFree MCP tools for UK electricians: cable sizing, Part P, certificate checks and G98/G99
- 7 tools
- Remote
- Free
- Home services
Nero Work
MCP serverTrades job exchange for AI agents: one checked electrician or plumber gets each offer
- Remote
- Paid
- Home services

Property Search
MCP serverSearch UK property, book viewings and get conveyancing quotes from an AI assistant
- 29 tools
- Remote
- Free
- Local services