hcpapi

Connect Housecall Pro to Claude Code

Claude Code manages MCP servers from the command line, so this is one command rather than a config file.

Setup

  1. Generate a Housecall Pro API key

    In Housecall Pro: My Apps, then Go to App store, then API Key Management. Choose Read-only unless you specifically want the MCP to be able to make changes. API access is a MAX-plan feature and you need an admin login.

    The full walkthrough, with a direct link to the page

  2. Add the MCP

    Run this in a terminal, with your own key.

    claude mcp add housecall-pro -e HCP_API_KEY=your-api-key-here -- npx -y housecall-pro-mcp

  3. Confirm it registered

    List your configured MCP servers and check housecall-pro is among them.

    claude mcp list

  4. Or install it as a plugin

    Instead of the command above, you can add it as a Claude Code plugin. It prompts for your key and keeps it in your keychain rather than a config file, and offers read-only mode and a toolset list as install-time options.

    /plugin marketplace add hcpapi/housecall-pro-mcp
/plugin install housecall-pro@hcpapi

Your first ask

Ask something you already know the answer to. If it agrees with you, everything is wired correctly. If it does not, you have found something worth knowing about your book.

how many jobs did each tech close last month?

Worth knowing

If it does not work

The two commonest causes are the plan and the header. API access is a MAX-plan feature, so on a lower plan there is no key to generate. And if you are hand-rolling requests rather than using the MCP, the auth header is Token, not Bearer. That one accounts for most "my key does not work" reports. The API guide covers the rest.

Still stuck: hello@hcpapi.com, or read the source, which is open.

← About the MCP