Housecall Pro Mcp

by toducthanh

404 downloads

Not rated

GitHub

Other

About

Housecall Pro Mcp is a Model Context Protocol server that exposes 70+ tools covering all Housecall Pro resources—Customers, Jobs, Estimates, Invoices, Leads, Employees, Tags, Materials, Price Book, Pipeline, Routes, Webhooks, and more. It is designed for users of the Housecall…

Details

Author: toducthanh
Downloads: 404
Categories: Other

- 70+ tools across all major Housecall Pro resources
- Tools for customers, jobs, estimates, invoices, and leads
- Schedule, dispatch, and manage employees and routes
- Manage tags, materials, price book, and pipeline stages
- Webhook subscription and company info retrieval
- Supports API key or OAuth 2.0 authentication

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Housecall Pro Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

From the repository

Install via Claude Code’s plugin marketplace using /plugin marketplace add toducthanh/housecallpro-mcp. Then configure the MCP server with either an API key (most common) or OAuth 2.0. Requires a Housecall Pro MAX plan and Node.js 20+. Run with npx -y @toducthanh/housecallpro-mcp@latest.

`list_customers`

Get a paginated list of customers. Search by name, email, mobile number or address using q. Set fetch_all:true to retrieve all pages automatically.

`get_customer`

Get a single customer by their ID.

`create_customer`

Create a new customer. At least one of first_name, last_name, email, mobile_number, home_number, or work_number is required.

`update_customer`

Update an existing customer's attributes.

`list_customer_addresses`

Get all addresses for a customer.

`get_customer_address`

Get a specific address for a customer by address ID.

`create_customer_address`

Create a new address on an existing customer.

`get_application`

Get the application for a company

`enable_application`

Enable the application for a company

`disable_application`

Disable the application for a company

`list_checklists`

Get checklists for jobs or estimates

`list_employees`

Get all active employees in the organization. Set fetch_all:true to retrieve all pages automatically.

`list_jobs`

Get a paginated list of jobs with optional filters. Set fetch_all:true to retrieve all pages automatically.

`get_job`

Get a single job by ID

`create_job`

Create a new job for an existing customer and address

`update_job_schedule`

Update a job's schedule

`delete_job_schedule`

Erase the schedule on a job

`dispatch_job`

Dispatch a job to employees

`add_job_attachment`

Add a file attachment to a job

`list_job_line_items`

List all line items for a job

`add_job_line_item`

Add a line item to a job

`bulk_update_job_line_items`

Bulk update all line items for a job

`list_job_input_materials`

List all input materials for a job

`bulk_update_job_input_materials`

Bulk update input materials for a job

`add_job_tag`

Add a tag to a job

`remove_job_tag`

Remove a tag from a job

`add_job_note`

Add a note to a job

`delete_job_note`

Delete a job note

`create_job_link`

Create a link on a job

`lock_job`

Lock a single job by ID

`lock_jobs_by_time_range`

Lock completed or scheduled jobs within a time range

`get_job_invoices`

List all invoices for a job

`list_job_appointments`

List all appointments for a job

`list_estimates`

Get a paginated list of estimates. Set fetch_all:true to retrieve all pages automatically.

`get_estimate`

Get a single estimate by ID

`create_estimate`

Create a new estimate

`list_invoices`

Get a paginated list of invoices. Set fetch_all:true to retrieve all pages automatically.

`list_leads`

Get a paginated list of leads. Set fetch_all:true to retrieve all pages automatically.

`get_lead`

Get a single lead by ID

`create_lead`

Create a new lead for an existing customer

`list_lead_sources`

Get a list of lead sources

`create_webhook_subscription`

Subscribe to webhook events for a company

`delete_webhook_subscription`

Unsubscribe from webhook events for a company

`list_materials`

Get a paginated list of materials. Set fetch_all:true to retrieve all pages automatically.

`get_material`

Get a single material by ID

`create_material`

Create a new material

`update_material`

Update an existing material

`delete_material`

Delete a material

`list_material_categories`

Get a list of material categories

`list_price_forms`

Get a list of price forms

`list_pricebook_services`

Get a paginated list of price book services. Set fetch_all:true to retrieve all pages automatically.

`get_pricebook_service`

Get a single price book service by ID

`create_pricebook_service`

Create a new price book service

`update_pricebook_service`

Update an existing price book service

`delete_pricebook_service`

Delete a price book service

`list_job_types`

Get a list of job types

`list_service_zones`

Get a list of service zones

`list_pipeline_statuses`

Get all pipeline statuses for leads, jobs, or estimates

`update_pipeline_status`

Move a resource forward in the pipeline

`list_routes`

Get a list of routes grouping employees and their scheduled work for a date

`get_company`

Get company information and settings

`get_schedule_windows`

Get the organization's business hours and bookable windows

`list_events`

Get a paginated list of events. Set fetch_all:true to retrieve all pages automatically.

`get_event`

Get a single event by ID

`list_tags`

Get a paginated list of tags. Set fetch_all:true to retrieve all pages automatically.

`create_tag`

Create a new tag

`update_tag`

Update a tag

`delete_tag`

Delete a tag

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "housecall pro mcp": {
            "housecallpro": {
                "command": "npx",
                "args": [
                    "-y",
                    "@toducthanh/housecallpro-mcp@latest"
                ],
                "env": {
                    "HOUSECALL_AUTH_METHOD": "apikey",
                    "HOUSECALL_API_KEY": "your-api-key"
                }
            }
        }
    }
}

McpServers

{
    "housecallpro": {
        "command": "npx",
        "args": [
            "-y",
            "@toducthanh/housecallpro-mcp@latest"
        ],
        "env": {
            "HOUSECALL_AUTH_METHOD": "apikey",
            "HOUSECALL_API_KEY": "your-api-key"
        }
    }
}

70+ tools across all Housecall Pro resources: Customers, Jobs, Estimates, Invoices, Leads, Employees, Tags, Materials, Price Book, Pipeline, Routes, Webhooks, and more.

Tools (70+)

| Tool | Description |
|------|-------------|
| list_customers | List and search customers |
| create_customer | Create a new customer with address |
| create_job | Create a job for a customer |
| update_job_schedule | Schedule a job with time window |
| dispatch_job | Assign job to a technician |
| create_estimate | Create an estimate with options and line items |
| list_invoices | List invoices with filters |
| create_lead | Create a lead and move through pipeline |
| convert_lead_to_job | Convert a lead to a booked job |
| get_booking_windows | Get available booking slots |
| list_employees | List active staff |
| get_company | Get company info and settings |
| subscribe_webhook | Register a webhook endpoint |
| list_tags | List and manage tags |
| list_materials | Browse price book materials |
| + 55 more | Covering all Housecall Pro API resources |

Installation (Claude Code)

Step 1 — Register the marketplace:

``

bash

/plugin marketplace add toducthanh/housecallpro-mcp





Step 2 — Install via

/plugin → Marketplaces tab → Browse plugins → find housecallpro-mcp

 → Install → Configure options.



Choose your auth method:



API Key (most common):

json

{

  "mcpServers": {

    "housecallpro": {

      "command": "npx",

      "args": ["-y", "@toducthanh/housecallpro-mcp@latest"],

      "env": {

        "HOUSECALL_AUTH_METHOD": "apikey",

        "HOUSECALL_API_KEY": "your-api-key"

      }

    }

  }

}





OAuth 2.0:

json

{

  "mcpServers": {

    "housecallpro": {

      "command": "npx",

      "args": ["-y", "@toducthanh/housecallpro-mcp@latest"],

      "env": {

        "HOUSECALL_AUTH_METHOD": "oauth",

        "HOUSECALL_CLIENT_ID": "your-client-id",

        "HOUSECALL_CLIENT_SECRET": "your-client-secret",

        "HOUSECALL_OAUTH_TOKEN": "your-access-token"

      }

    }

  }

}

``

> Requires Housecall Pro MAX plan and Node.js 20+.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

list_customers

get_customer

create_customer

update_customer

list_customer_addresses

get_customer_address

create_customer_address

get_application

enable_application

disable_application

list_checklists

list_employees

list_jobs

get_job

create_job

update_job_schedule

delete_job_schedule

dispatch_job

add_job_attachment

list_job_line_items

add_job_line_item

bulk_update_job_line_items

list_job_input_materials

bulk_update_job_input_materials

add_job_tag

remove_job_tag

add_job_note

delete_job_note

create_job_link

lock_job

lock_jobs_by_time_range

get_job_invoices

list_job_appointments

list_estimates

get_estimate

create_estimate

list_invoices

list_leads

get_lead

create_lead

list_lead_sources

create_webhook_subscription

delete_webhook_subscription

list_materials

get_material

create_material

update_material

delete_material

list_material_categories

list_price_forms

list_pricebook_services

get_pricebook_service

create_pricebook_service

update_pricebook_service

delete_pricebook_service

list_job_types

list_service_zones

list_pipeline_statuses

update_pipeline_status

list_routes

get_company

get_schedule_windows

list_events

get_event

list_tags

create_tag

update_tag

delete_tag

Claude Desktop / Cursor

McpServers

Tools (70+)

Installation (Claude Code)

Install

More like this

Sequential Thinking

`list_customers`

`get_customer`

`create_customer`

`update_customer`

`list_customer_addresses`

`get_customer_address`

`create_customer_address`

`get_application`

`enable_application`

`disable_application`

`list_checklists`

`list_employees`

`list_jobs`

`get_job`

`create_job`

`update_job_schedule`

`delete_job_schedule`

`dispatch_job`

`add_job_attachment`

`list_job_line_items`

`add_job_line_item`

`bulk_update_job_line_items`

`list_job_input_materials`

`bulk_update_job_input_materials`

`add_job_tag`

`remove_job_tag`

`add_job_note`

`delete_job_note`

`create_job_link`

`lock_job`

`lock_jobs_by_time_range`

`get_job_invoices`

`list_job_appointments`

`list_estimates`

`get_estimate`

`create_estimate`

`list_invoices`

`list_leads`

`get_lead`

`create_lead`

`list_lead_sources`

`create_webhook_subscription`

`delete_webhook_subscription`

`list_materials`

`get_material`

`create_material`

`update_material`

`delete_material`

`list_material_categories`

`list_price_forms`

`list_pricebook_services`

`get_pricebook_service`

`create_pricebook_service`

`update_pricebook_service`

`delete_pricebook_service`

`list_job_types`

`list_service_zones`

`list_pipeline_statuses`

`update_pipeline_status`

`list_routes`

`get_company`

`get_schedule_windows`

`list_events`

`get_event`

`list_tags`

`create_tag`

`update_tag`

`delete_tag`