# Housecall Pro MCP

> Housecall Pro MCP is an open-source MCP server for home services. Open-source Housecall Pro API server for jobs, estimates, invoices and the price book. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://hcpapi.com/mcp/
- **Repository:** https://github.com/hcpapi/housecall-pro-mcp
- **MCP Registry name:** io.github.hcpapi/housecall-pro-mcp
- **Categories:** home services
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add housecall-pro-mcp --env HCP_API_KEY='<HCP_API_KEY>' -- npx -y housecall-pro-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "housecall-pro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "housecall-pro-mcp"
      ],
      "env": {
        "HCP_API_KEY": "<HCP_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "housecall-pro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "housecall-pro-mcp"
      ],
      "env": {
        "HCP_API_KEY": "<HCP_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "housecall-pro-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "housecall-pro-mcp"
      ],
      "env": {
        "HCP_API_KEY": "<HCP_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "housecall-pro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "housecall-pro-mcp"
      ],
      "env": {
        "HCP_API_KEY": "<HCP_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "housecall-pro-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "housecall-pro-mcp"
      ],
      "env": {
        "HCP_API_KEY": "<HCP_API_KEY>"
      }
    }
  }
}
```

## Tools

- `hcp_list_jobs`: List jobs in the Housecall Pro account

## 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

- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [HALPII](https://ai-powered.com/mcp/halpii): HALPII is a free MCP server for home services.
- [Spark Pack](https://ai-powered.com/mcp/spark-pack): Spark Pack is a free MCP server for home services.
- [Nero Work](https://ai-powered.com/mcp/nero-work): Nero Work is a paid MCP server for home services.
- [Property Search](https://ai-powered.com/mcp/property-search): Property Search is a free MCP server for local services.
- [Wanbao House](https://ai-powered.com/mcp/wanbao-house): Wanbao House is a free MCP server for community directories.
- [BKK Radar](https://ai-powered.com/mcp/bkk-radar): BKK Radar is a free MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/housecall-pro-mcp
