ZenHome connector documentation
Connect ZenHome to Claude or ChatGPT and your AI can act on your home. Here’s how to set it up, what each tool does, how your data is scoped, and how to fix common snags.
Setup · about a minute
Connect ZenHome to your AI
https://zenhome.ai/api/mcp- 1
Open your AI app’s connector settings
In Claude: Settings → Connectors → Add custom connector (not Settings → Developer, which is for servers on your own computer). In ChatGPT, on the web: turn on Developer mode under Settings → Security and login, then create a developer-mode app from Plugins. Coding agents (Claude Code, Cursor, Codex) take the same URL as a remote MCP server.
- 2
Add the ZenHome connector URL
Paste the connector URL below. No app to install.
- 3
Sign in with your ZenHome account
Same sign-in as the app: the phone or email on your account and the code we send, or Google, Microsoft or Apple. No password to create.
- 4
Approve access and start
Approve access, then ask. Claude has ZenHome in every new chat. In ChatGPT, turn it on in each chat from the + menu under Developer mode.
What your AI can do
The tools ZenHome adds, by role
Your ZenHome account decides which set your AI sees when it connects. Homeowners get the first list; field techs the second; ZenHome coordinators the third; StoneLink coordinators the fourth. The lists below are generated from the same tables the server uses, so they can’t drift from what actually runs.
- Looks upreads only, changes nothing
- Recordswrites to ZenHome, nothing leaves the building
- Asks firstreaches a person or commits work, so your AI app confirms first
Homeowners · 9 tools
4 look things up, 4 ask first. Every call is scoped to your own projects and property; a message to your team or a request for a visit is read by a person before anything changes. Plain-English tour: the homeowner page.
Find your projects
searchProjectsLists the projects on your ZenHome account, open and finished.
“Show me all my projects and which ones are still open.”
Check status and schedule
getContextReads where a project stands, what happens next, who is scheduled, and the messages on it.
“Where is my kitchen remodel at, and who is coming this week?”
Know your house
propertyAnalyzerSays what a house of your home’s age usually needs before work starts: likely permits, era risks like lead paint or old galvanized pipe, and access or HOA limits.
“My house was built in 1924. What should I know before we open up the kitchen?”
Read your project photos
analyzeMediaDescribes what the photos already on your project show, and answers questions about them.
“Does the tile in the latest photos match what we picked?”
Start a project
createProjectOpens a new project on your account from an address and a description. It starts as a lead; nothing is booked or priced until a person reviews it.
“Start a project for the bathroom we just scoped.”
Ask for a visit
manageAppointmentAsks for a visit to your home. A person on the team approves it before it’s booked. To move or cancel one, message your home team.
“Ask for someone to look at the leak under the sink next week.”
Add photos
addProjectPhotosAttaches photos you share in the chat to your project so the team sees what you see.
“Add these three photos of the leak to my plumbing project.”
Message your home team
communicateDrafts a message to your home team at ZenHome about one of your projects. You confirm it, and a team member reads it and gets back to you.
“Tell my home team I want to add a tile backsplash and have them update the quote.”
Review your design
reviewMyDesignReads the 3D model shared on your project: what it covers, its rooms, a download of the file, your comments and the team’s, and what changed in the latest model. Replies to a comment, or tells the team an update looks right or still needs work.
“What changed in the latest model of my house, and what is still open?”
Field techs · 6 tools
Assigned jobs only. A message to a customer or a request for a visit goes to the office for approval first. Moving or cancelling a visit, staffing and work dates go through the coordinator.
Pull up the job
getContextReads the project: scope, status, the schedule, the customer’s notes, and recent messages.
“What’s the scope on my 1pm, and is there a gate code?”
Find a job
searchProjectsFinds projects you are assigned to by customer name, address, or status.
“Find the Hatfield bathroom job.”
Log progress
manageProjectUpdates a project record you are on: a summary of what was done, a status change, or a note for the coordinator.
“Log that the rough-in is done and we’re waiting on inspection.”
Add job photos
addProjectPhotosAttaches before and after photos to the project from the chat.
“Add these photos to the Chestnut St job.”
Ask for a visit
manageAppointmentAsks for a return visit on one of your jobs, which the office approves before it’s booked, and shows who else is on a job. Moving or cancelling a visit, and staffing, go through the office.
“Book a return visit to the Chestnut St job Friday morning.”
Message the customer
communicateDrafts a text to the customer on one of your jobs. The office approves it before it goes out.
“Let the customer know the part didn’t arrive and I’ll be back tomorrow morning.”
ZenHome coordinators · 52 tools
12 read, 27 write internal records, 13 reach a person. A customer message or a schedule change comes back as an approval card in ZenLink, and nothing goes out until it’s approved. Money movement, customer-facing quote and report sends, and account creation are not on the connector. Worked examples: the team page.
Find projects
searchProjectsSearches projects by customer, address or status, and answers pipeline questions in one look: waiting on a quote, quoted, approved with no visit, unpaid, gone quiet.
“Which projects are waiting on a quote from us right now?”
Read a project or contact
getContextPulls the full picture: status, timeline, communications, and contact lookup by phone or name.
“Who is 401-555-0100, and what have we told them so far?”
What’s next on a project
getProjectNextStepsThe same ranked next-steps queue the project page shows: open tasks, pending sends, scheduled follow-ups.
“What’s blocking the Harlow kitchen right now?”
Look up a property
propertyAnalyzerYear built, systems, and permit considerations for an address, before a walkthrough.
“Anything I should know about 84 Chestnut before Tuesday’s visit?”
Check the playbook
getSopReads a section of the standard operating procedures: pricing tiers, the labour rate, trade rates, and the rest. For StoneLink staff, also the how-to guide for ZenLink, in English or Spanish.
“What’s our hourly rate for electrical, and which flat-rate tier does a faucet swap fall in?”
Read project documents
analyzeDocumentsLists and reads the invoices, receipts, permits, and contracts attached to a project.
“Summarize the permits on file for the Warwick deck.”
Read project photos
analyzeMediaLists the photos on a project and describes what they show.
“What do the photos from yesterday’s visit show at the Cranston job?”
Draft an estimate
generateEstimateBuilds a line-item estimate from the project scope. Takes a moment and costs an AI call, so use it when a project has none yet.
“Draft an estimate for the Smith bathroom from the walkthrough notes.”
Edit an estimate
refineEstimatesAdds, changes, or removes line items on an existing estimate.
“Add a $450 disposal line and bump tile labour to 16 hours.”
Link photos and video to a line
manageLineEvidenceTies an estimate line to the photos and video moments that show its work, or unties them.
“Put the 0:42 moment of the kitchen walkthrough on the ceiling repair line.”
Pick fixtures for an estimate
manageFixturesLists the fixture lines on an estimate (a baseboard, radiator, sink), finds up to three fits in our catalog, and puts the one you pick on the line. Shows brand, model, size and list price, never a supplier or our cost.
“Find a baseboard for the bedroom line on the Nisbet estimate.”
Send an estimate to Housecall Pro
sendEstimateToHousecallProShows where a job's estimate would go in Housecall Pro (the job's estimate there, an open one at the address, or a new one for the customer), option by option at the customer's price, and sends it for approval. Nothing reaches Housecall Pro until someone approves, and nothing goes to the customer.
“Send the 36 Methyl water heater estimate to Housecall Pro.”
Pull Housecall Pro changes into ZenLink
pullInHousecallProEditsLists what the office changed in Housecall Pro on an estimate ZenLink sent there, with what taking each one does, and takes the ones you pick into ZenLink's estimate. Nothing goes back to Housecall Pro or to the customer.
“What did the office change on the water heater quote in Housecall Pro? Pull in the new price.”
Automatic customer texts
manageCustomerTextsShows which automatic texts a job's customer gets (visit booked, the reminder, on my way, job done) and what was sent or is queued, pauses them on one job, and changes a company's wording. Nothing is sent by it.
“Did the Elm St customer get the reminder? Stop the texts on that job.”
Archive a draft estimate
archiveEstimateSoft-deletes a draft estimate. Reversible.
“Archive the old DIY estimate on the Harlow job.”
Set material selections
manageSelectionsReads or sets the per-room material picks (tile, vanity, faucet) the homeowner sees on their plan.
“Set the floor tile to the mid option and the vanity to premium.”
Check the product library
manageCatalogLooks up and updates the products we have specified before, so a quote uses the price on file.
“What did we last spec for a 36-inch vanity, and at what price?”
Work a job’s Design & planning
managePlanningReads and saves a job’s Design & planning records: fixture decisions and fit checks, proposed changes and saved versions, materials and orders with their receipts, drawing feedback and 3D models. Saving records the change; it never approves a design, places an order or moves money.
“What’s still open on the Nisbet bathrooms? Log the supplier’s tub confirmation from this email.”
Update a project
manageProjectCreates or updates a project: status, summary, contact, project manager, assigned tech, or company.
“Assign Ray as lead on the Hatfield job and mark it scheduled.”
Update a contact
manageContactsCreates or edits a customer contact: name, phone, email, address.
“Add the tenant’s number to the Chestnut contact.”
Work the inbox
manageInboxLists who texted or called, newest first, and which of them have no job yet. Dismisses a lead as spam, a wrong number, not interested or a duplicate (archived, not deleted), and moves a text or call the router was unsure about to the right job, photos included.
“Any new leads today? Dismiss the two that are spam.”
Schedule work
manageAppointmentBooks, moves, or cancels visits, assigns techs, and sets work dates, each as an approval card in ZenLink that runs once it’s approved. Lists who is available and who is on a job right away.
“Put the Cranston deck on Thursday and Friday with Ray and Tomas.”
Read PM billing
getPmBillingShows StoneLink Plumbing's jobs for Stonelink PM that need someone: not invoiced, still open, a leftover duplicate, sent for PM to enter, or unpaid 30+ days.
“Which PM jobs have not been invoiced yet?”
Read the estimating dashboard
getEstimatingDashboardShows how fast a company’s Housecall Pro quotes go out after the visit, by plumber, job type and size, how many come back approved, and which estimates are still waiting for a quote. Dollar amounts only if your account can see money.
“How fast are StoneLink Plumbing’s quotes going out since the kickoff?”
Read the schedule board
getScheduleBoardShows who is where for a day or a week, narrowed to one company or to the techs you name, and the work orders nobody is on yet with how long each has waited. Only the companies you can see are on it.
“What is on StoneLink Plumbing’s board tomorrow?”
Message a customer or tech
communicateTexts a customer on a project, or emails them a quote. It becomes an approval card in ZenLink with the exact message, and nothing goes out until it’s approved.
“Text the homeowner that we’re running 30 minutes late.”
Schedule a follow-up
scheduleFollowupQueues a follow-up message for later that only sends if its conditions still hold (for example, the quote is still unanswered).
“If they haven’t approved the quote by Monday, nudge them.”
Track a task
manageTaskCreates, assigns, and lists internal tasks across projects.
“Make a high-priority task for me to call back about tile selection by Friday.”
Add visit media to a checkup
ingestVisitMediaPulls a walkthrough video or photos into a property visit so the checkup can be generated from them.
“Add this walkthrough video to the 84 Chestnut visit.”
Generate a checkup report
generateCheckupReportStarts checkup generation from the recorded walkthroughs. Takes a few minutes; read it back when it finishes.
“Regenerate the checkup at 84 Chestnut, the last one came out truncated.”
Read a checkup report
getCheckupReportReads the draft or finished checkup for a property.
“Give me the findings from the Hatfield checkup.”
Read a unit’s inspection history
getUnitInspectionHistoryLists a unit’s Move Out, Pre-clean, Move In and other inspections with links to the reports, and the rooms and last notes the next inspection there starts with. Reads one report’s rooms and notes on request.
“What did unit 2 at 155 Elmwood have at its last Move Out?”
Edit checkup findings
editCheckupFindingsAdds, edits, or removes findings on a draft checkup, including tenant-caused damage and estimates.
“Add the broken screen door as a tenant-tagged finding at $180.”
Fix a photo label
editVisitMediaMetaCorrects a photo’s room or caption on a checkup.
“That photo is the second bathroom, not the kitchen.”
Remove stray media
archiveVisitMediaArchives a photo or clip that doesn’t belong on a checkup. Reversible.
“Drop the two laptop screenshots from the Hatfield checkup.”
Fix technician names
manageTechnicianRenames a technician, adds the other names they go by, and matches a person from Property Meld, Housecall Pro, zInspector or a payroll file to them, moving their past jobs over. Looking things up is instant; every change waits on one approval card.
“Jeff Lombardi shows up as Jeffrey in Meld. Merge them and move his past jobs.”
Text the field crew
manageFieldBroadcastTexts or emails a company's field technicians or office staff one message and a link to acknowledge it, now or at a time you choose. It can also group-text a few named people in one shared thread from the company's line, so they can reply to each other. Looking up the team is instant; the message waits on one approval card, and nobody hears from it until it is approved.
“Text the StoneLink crew at 7 tomorrow morning to check their work orders in the app.”
Time off and who's out
manageTimeOffShows who's out and what's waiting for approval, with the visits already booked on those days; asks for time off; and approves, declines or cancels it. Looking is instant; each decision waits on one approval card an approver taps.
“Who's out the week of December 21? Approve Hector's request if nobody else on his crew is off.”
Merge duplicate homes
mergeHomesChecks a list of duplicate home records, or apartments saved apart from their building, and says what would move: jobs, people, and the unit an apartment lands on. It refuses a pair whose street number, street, unit, ZIP or town disagree. Merging waits on one approval card for the whole list.
“The three records for 12 Elm St are one house. Merge them into the one with the most jobs.”
Who gets our reports
manageNotificationsLists every report and alert we send (daily digests, the ops pulse, payroll nudges, Slack alerts, team emails) with when it goes and who gets it, and the buildings a report like PCF Development maintenance hours covers. Pausing one, adding or removing people, switching email or Slack on, and changing a report's buildings apply at once; a partner manager adding someone outside their own company waits on one approval card. Preview a report as it would go out now, or email yourself a test copy. Partner managers see the reports about their own companies.
“Add Justin Mann to the PCF Development maintenance hours report, and add 15 Jackson Street to its buildings.”
Set scorecard goals
manageScorecardLists the weekly scorecard measurables with their goals, and changes a goal. Admins only.
“Set the lead response time goal to 5 minutes.”
Ask the customer for a decision
manageCustomerAsksDrafts what we need from a homeowner, shown at the top of their customer page: a decision, or a list we settle with them in a call. Drafts are never on their page; sending one waits on an approval card that shows the exact words and the one text they will get.
“Draft the 4 tile choices for 42 Nisbet as one list, due Monday, and send it for approval.”
Record a meeting with the homeowner
manageMeetingsRecords a meeting with the homeowner, onsite or on a call: notes, follow-ups, and what each open decision settled to for the coordinator to confirm. It can draft the record from a walkthrough, a call or a Meet transcript for you to check, and sharing the notes on their page waits on an approval card.
“Fill in Thursday’s meeting at 42 Nisbet from the walkthrough, then show me what it says before saving.”
Invoices and payments
processPaymentShows what a customer still owes on a job and their pay link, straight from Stripe. Asks for approval to create an invoice, record a payment made by cash or check, or text the customer their pay link for the balance. Nothing changes until someone with money access approves it in ZenHome.
“The Hendersons paid the rest by check, number 1042. Mark the final invoice paid.”
Quote payment schedule
manageQuoteReads a quote’s payment schedule, and asks for approval to change it or the deposit. Each change is one card showing today beside after; nothing changes until someone approves it in ZenLink. The margin and a flat price stay in ZenLink.
“On the Maple St quote, take a 30% deposit and add an $850 permit fee before we start.”
Change orders
manageChangeOrderLists a job’s change orders and proposes a new one for added or removed work. A proposal bills nothing: a coordinator approves it on the job page, and the homeowner approves an increase.
“Add a change order for the railing repair, our cost $1,293.”
Clean up a customer account
manageAccountMoneyFinds customer accounts whose closed jobs still have open quotes or unpaid invoices, reviews one account job by job, and proposes the cleanup as one approval card: archive the closed jobs, close what they left open, and correct payment statuses that say paid while money is still owed. Nothing changes until someone with money access approves it, and the customer is never contacted.
“Review the 51 Plaza St account and propose cleaning up the old jobs.”
Process product feedback
manageProductFeedbackUploads an interview video where someone talks through the product, pulls out the bugs, friction and requests they mention, and reads the findings back. Takes a few minutes per video.
“Upload ~/Movies/clockin.mov as product feedback and tell me what they found.”
Edit a job's scope
manageScopeReads and edits a job's scope list: the work in the customer's words, filed under the job's phases, with what the customer sees kept apart from notes for the crew. Saved at once and logged; nothing is sent to the customer.
“Add stain and seal the whole deck to the Jamestown deck scope, under Finish.”
Compare supplier prices
manageVendorSearchStarts a price check at your company's suppliers, on a Housecall Pro estimate's parts or on one item, keeps each price read with when and where it was found, and shows every past check on an estimate against the estimate's own costs. On a ZenLink estimate it can save the price you pick as a line's cost. Nothing is ordered. ZenHome staff only for now.
“Price estimate 3819, Option #2, at our plumbing suppliers.”
Add project photos
addProjectPhotosAttaches photos from the chat to a project.
“Add these to the Warwick job as before photos.”
File a document
processFileUploadClassifies and saves a document you attach (a receipt, a permit, a supplier invoice) to the right project.
“File this Home Depot receipt against the Harlow kitchen.”
StoneLink coordinators · 20 of those tools
StoneLink accounts connect with the coordinator toolset, fenced to StoneLink jobs. They can use the tools below; the two that change anything draft an estimate and add job photos. The rest of the coordinator list is refused for StoneLink accounts, so schedules, messages and checkup edits stay in the app.
Find projects
searchProjectsSearches projects by customer, address or status, and answers pipeline questions in one look: waiting on a quote, quoted, approved with no visit, unpaid, gone quiet.
“Which projects are waiting on a quote from us right now?”
Read a project or contact
getContextPulls the full picture: status, timeline, communications, and contact lookup by phone or name.
“Who is 401-555-0100, and what have we told them so far?”
Look up a property
propertyAnalyzerYear built, systems, and permit considerations for an address, before a walkthrough.
“Anything I should know about 84 Chestnut before Tuesday’s visit?”
Check the playbook
getSopReads a section of the standard operating procedures: pricing tiers, the labour rate, trade rates, and the rest. For StoneLink staff, also the how-to guide for ZenLink, in English or Spanish.
“What’s our hourly rate for electrical, and which flat-rate tier does a faucet swap fall in?”
Read project photos
analyzeMediaLists the photos on a project and describes what they show.
“What do the photos from yesterday’s visit show at the Cranston job?”
Draft an estimate
generateEstimateBuilds a line-item estimate from the project scope. Takes a moment and costs an AI call, so use it when a project has none yet.
“Draft an estimate for the Smith bathroom from the walkthrough notes.”
Read an estimate
refineEstimatesReads an estimate, compares two, or finds which one is live. Editing line items stays in the app.
“What’s on the 84 Chestnut estimate, and is it the live one?”
Read a project’s design plan
managePlanningReads a project’s decisions, proposed changes, orders and drawing review. Saving any of them stays in the app.
“What decisions are still open on the 9 Pine remodel?”
Read a project’s details
manageProjectReads a project’s details and where it stands. Changing a project stays in the app.
“Where does the 9 Pine turnover stand?”
Schedule your jobs
manageAppointmentBooks, moves or cancels visits on your company’s jobs, sets work dates and puts your own techs on a job. Each one waits for you to approve it in ZenLink. Shows your techs and who’s on a job right away.
“Put Ray on the Oak St make-ready Thursday at 9.”
Read PM billing
getPmBillingShows StoneLink Plumbing's jobs for Stonelink PM that need someone: not invoiced, still open, a leftover duplicate, sent for PM to enter, or unpaid 30+ days.
“Which PM jobs have not been invoiced yet?”
Read the estimating dashboard
getEstimatingDashboardShows how fast a company’s Housecall Pro quotes go out after the visit, by plumber, job type and size, how many come back approved, and which estimates are still waiting for a quote. Dollar amounts only if your account can see money.
“How fast are StoneLink Plumbing’s quotes going out since the kickoff?”
Read the schedule board
getScheduleBoardShows who is where for a day or a week, narrowed to one company or to the techs you name, and the work orders nobody is on yet with how long each has waited. Only the companies you can see are on it.
“What is on StoneLink Plumbing’s board tomorrow?”
See a project’s tasks
manageTaskLists the open tasks on a project. Creating or assigning a task stays in the app.
“What tasks are still open on the 45 Main St job?”
Read a checkup report
getCheckupReportReads the draft or finished checkup for a property.
“Give me the findings from the Hatfield checkup.”
Read a unit’s inspection history
getUnitInspectionHistoryLists a unit’s Move Out, Pre-clean, Move In and other inspections with links to the reports, and the rooms and last notes the next inspection there starts with. Reads one report’s rooms and notes on request.
“What did unit 2 at 155 Elmwood have at its last Move Out?”
Check who a name is
manageTechnicianFinds a tech, the other names they go by, and the names from Meld or payroll files still waiting to be linked. Linking or renaming stays in the app.
“Which Meld names haven’t been linked to one of our techs yet?”
Time off and who's out
manageTimeOffShows who's out and what's waiting for approval, with the visits already booked on those days; asks for time off; and approves, declines or cancels it. Looking is instant; each decision waits on one approval card an approver taps.
“Who's out the week of December 21? Approve Hector's request if nobody else on his crew is off.”
Add project photos
addProjectPhotosAttaches photos from the chat to a project.
“Add these to the Warwick job as before photos.”
Read a document
processFileUploadReads a document you attach, like a move-out inspection or a receipt, and says what it shows. Filing it on a project stays in the app.
“Read this move-out inspection and list what needs fixing.”
Privacy & scope
Your home. Your data. Your call.
- ✓Scoped to you. The connector only ever sees your own projects and property, never another customer’s.
- ✓Read-first. Most tools only read. Anything that reaches a person or commits work is confirmed in your AI app first, and a homeowner message is read by a team member before anything changes.
- ✓You stay in control. No payments, no account changes, no quotes or reports sent to customers. The connector can’t do any of that, for anyone.
Full details: Privacy Policy · Terms of Service
Troubleshooting
Common snags
- I can’t sign in.
- Sign in the way you do in the app: the phone or email on your ZenHome account and the code we send, or Google, Microsoft or Apple. There’s no password.
- ChatGPT answers without using ZenHome.
- In ChatGPT a developer-mode app is off until you pick it. Open the + menu in the chat, choose Developer mode, select ZenHome, and ask again.
- I work at ZenHome or StoneLink and it only shows me homeowner tools.
- The connector reads the role on your ZenLink account. If your account was never set up with a coordinator or technician role, it falls back to the homeowner set. Ask your ZenHome coordinator to check your account, then disconnect and reconnect.
- My AI says I have no projects.
- Projects are scoped to your account. You’ll see a project only if you’re its homeowner or a listed contact. If you expected one, reach out to your ZenHome team.
- The connector won’t add.
- Make sure you entered https://zenhome.ai/api/mcp exactly, and that your AI app supports custom MCP connectors with OAuth sign-in.
- It won’t send my message.
- That’s by design. The connector drafts messages and only sends them after you confirm. Your AI can’t message your team on its own.
Still stuck?
Your ZenHome project team can help, or start fresh below.