
请阅读承包商发给你的客户链接中的Housecall Pro报价——MCP服务器+卷举技能。通过HTTPS直接与 app.housecallpro.com 沟通;无需浏览器扩展。
概览
一个模型上下文协议服务器,连接Claude与Housecall Pro——估价或发票链接,承包商(暖通空调、管道、电气、清洁)通过电子邮件或短信联系你。 该代码库由 Claude Code 构建并积极维护。没有人工审核过实现。使用前请审查所有代码和工具权限。 Housecall Pro 有两个表面,它们没有共享任何东西: 如果你用 Housecall Pro 运营企业,你更希望使用公共 API。这个服务器是用来做某人的客户的。 - “我的水管工给我报了无储水箱冲水的报价吗?”- “那个报价里,逐行说明了什么?”- “那346美元里有多少是税?”- “我还得回复吗?”- “拒绝选项2。” 用承包商发给你的链接来配置: 估算和发票链接都有效,无论是短版还是长版——pro.housecallpro.com/mobile_estimate/......和 /mobile_invoice/......,或者 client.housecallpro.com/estimates/......以及 /发票/......
概述(AI 翻译)
一个连接 Claude致Housecall Pro的客户端—— 估价或发票联系承包商(暖通空调、管道、电气、清洁) 给你发邮件或短信。
[!警告] AI开发的项目。 该代码库由开发并积极维护 由克劳德·代码制作。没有人类审计过 实现。使用前请审查所有代码和工具权限。
这是客户那边,不是生意边
Housecall Pro 有两个表面,它们没有共享任何东西:
| 公共API | 客户门户(本仓库) | |
|---|---|---|
| 主持人 | api.housecallpro.com |
app.housecallpro.com |
| 服务 | 在Housecall Pro上运营的企业 | 该企业的客户 |
| 认证 | 来自专业人士账户的API密钥 | 你的承包商发给你的链接 |
| 医生 | docs.housecallpro.com | docs/HOUSECALLPRO-API.md |
如果你用Housecall Pro经营*企业,你更希望用公开API。就是这样 服务员是用来做别人的顾客。
你能做什么
- “我的水管工给我报价了多少,关于无罐冲水?”
- “那份估算上,逐行说明了什么?”
- “那346美元中有多少是税?”
- “我还需要回复吗?”
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
Housecall Pro MCP
A Model Context Protocol server that connects Claude to the customer side of Housecall Pro — the estimate or invoice link a contractor (HVAC, plumbing, electrical, cleaning) emails or texts you.
[!WARNING] AI-developed project. This codebase was built and is actively maintained by Claude Code. No human has audited the implementation. Review all code and tool permissions before use.
This is the customer side, not the business side
Housecall Pro has two surfaces, and they share nothing:
| Public API | Customer portal (this repo) | |
|---|---|---|
| Host | api.housecallpro.com |
app.housecallpro.com |
| Serves | the business running on Housecall Pro | that business’s customers |
| Auth | an API key from the pro’s account | the link your contractor sent you |
| Docs | docs.housecallpro.com | docs/HOUSECALLPRO-API.md |
If you run a business on Housecall Pro, you want the public API instead. This server is for being someone’s customer.
What you can do
- “What did my plumber quote me for the tankless flush?”
- “What’s on that estimate, line by line?”
- “How much of that $346 is tax?”
- “Am I still on the hook to respond to this?”
- “Decline option 2.”
Install
npx -y @chrischall/housecallpro-mcp
Configure it with the link your contractor sent you:
HOUSECALLPRO_LINK='https://pro.housecallpro.com/mobile_estimate/XXXXXXXXXX'
Estimate and invoice links both work, short or long form —
pro.housecallpro.com/mobile_estimate/… and /mobile_invoice/…, or
client.housecallpro.com/estimates/… and /invoices/…. For several documents:
HOUSECALLPRO_LINKS='[{"label":"tankless","url":"…"},{"label":"hvac","url":"…"}]'
Then every tool takes an optional link selector; with one configured you never
need it.
[!IMPORTANT] Your link is a bearer credential. Anyone holding it can read the document and, for an estimate, decline it. It is read from the environment, never logged, and never returned in a tool result —
housecallpro_list_linksreports labels only.
Confirmations
Declining asks you first. A client that can show a confirmation prompt (Claude
Code) shows one. On a client that cannot (claude.ai, Claude Desktop) the first
call declines nothing and returns a preview plus a confirmToken; only a repeat
call with that token acts, and only if the estimate still matches what was
previewed.
安装
npx -y @chrischall/housecallpro-mcp