MCP App Store
by KeenEthics
Village for Home Services icon

Village for Home Services MCP Server for Claude

By Village Technology Services, LLC

Overview

Village is the business app for home service providers: cleaners, landscapers, pressure washers and other local pros. Connect it to Claude to ask about your week, see who owes you money, and find open time on your calendar. Claude can add customers and notes, draft quotes and invoices, and put jobs on your calendar. Anything Claude drafts is labeled so you can review it in Village. When you want to send a quote, an invoice or a payment reminder, Claude shows you the exact text message and who it goes to, and sends only after you say yes. Claude can’t delete anything, take payments or change your plan. Requires a Village account.

How to connect

  1. Claude: Open the Village for Home Services listing in the Claude connectors directory and choose Connect. Claude listing Village for Home Services exposes 24 tools here.

Tools

add_customer_note

Claude
Add a dated private note to a customer. Notes are only visible to the provider. Requires edit access.

confirm_crew_change

Claude
Step 2 of 2: apply exactly what prepare_crew_change previewed. Only call after the owner saw the preview and said yes in this conversation. Adding someone to an upcoming job texts them the details. Marking paid only records it; Village does not send money. The token expires after 10 minutes and works once; if anything changed since the preview, this refuses. Requires edit access.

confirm_page_update

Claude
Step 2 of 2: save exactly what an update_* tool previewed. Only call after the provider saw the changes and said yes in this conversation. The token expires after 10 minutes and works once; if the page changed since the preview, this refuses and asks for a new one. Requires edit access.

confirm_send

Claude
Step 2 of 2: deliver exactly what prepare_send previewed. Only call this after the provider has seen the preview and said yes in this conversation. The token expires after 10 minutes and works once; if anything changed since the preview, this refuses and asks for a new preview. Requires edit access.

create_customer

Claude
Add a customer to the provider's Village CRM. If a customer with the same phone or email already exists, returns that customer instead of creating a duplicate. Requires edit access (village:write).

create_job

Claude
Put a job on the provider's calendar for a local date and start time. The customer is NOT notified; there is no calendar invite or text. Use get_availability first to find an open time. Requires edit access.

draft_invoice

Claude
Create a draft invoice from a quote (quoteId), from a job (jobId), or from line items. It is saved as a draft and is NOT sent. Prices are in cents. If the plan's monthly invoice limit is used, the draft is still saved and the response includes an upgrade link. Requires edit access.

draft_quote

Claude
Create a draft quote. Use list_services for prices and ids. The quote is saved as a draft and is NOT sent to the customer; the provider reviews and sends it in Village. Prices are in cents. The job address comes from the customer unless one is passed, and Village matches it on the map so the quote can be sent later; check addressVerified in the response. If the plan's monthly quote limit is used, the draft is still saved and the response includes an upgrade link. Requires edit access.

get_availability

Claude
Open time windows per day for the provider, with booked jobs removed. Dates and HH:MM times are already in the provider's local timezone (returned as timezone); show them as-is. Defaults to the next 7 days.

get_booking_page_status

Claude
What's set and what's missing on the provider's public booking page: logo, services with prices, service area, hours, headline and description. Use when they ask what's missing, want to finish setup, or before walking them through it. Lists which tool fixes each item.

get_business_snapshot

Claude
Use this first when the provider asks how their business is doing. Returns business name, plan, storefront URL, this week's job count, outstanding invoice total, and pending quote count (Quote rows in sent/viewed — use list_quotes for details, not list_jobs). Provider-scoped; no arguments.

get_crew_pay

Claude
What the provider owes their crew and for which jobs, matching Crew > Payroll in Village. Use for 'how much do I owe my crew', 'what do I owe Alex', or who got paid. Default window=outstanding is everything still owed. window=range with from/to (YYYY-MM-DD job days) also shows what was paid. Each job line has a dispatchId for prepare_crew_change. Also lists pay waiting on the owner to approve hours, and finished jobs payroll skips because the crew part was never marked done. Show the summary as-is.

get_customer

Claude
Get one CRM customer by UUID, including recent jobs (up to 10, each with scheduledAtLocal in the provider's local time) and open quote/invoice counts. Use after list_customers when you need history for a specific customer. Provider-scoped.

get_growth_check

Claude
Call this first whenever the owner asks how to grow, get more customers, get more jobs, or market their business. Returns their own numbers (booking page views, new bookings and leads in the last 30 days; review requests sent vs reviews received and finished jobs never asked for a review; past customers who have not booked in 90+ days; what is missing from the booking page; instant quote form; referral credit), their booking link and QR image URL, and ranked moves, each with why (built from their numbers) and doNow. Lead with the top one or two moves for this owner, using the numbers in why, then offer to do one now. Give generic tips (Google Business Profile and the like) only after those, as a fallback. Never invent numbers that are not here. No arguments.

get_invoice

Claude
Get one invoice by UUID with its line items, customer contact, totals and tip in cents, due/paid dates, isOverdue, the last send failure if any, and the public viewer URL. Use after list_invoices. Requires a plan that includes invoicing.

get_marketing_kit

Claude
Everything needed to design a door hanger, postcard, flyer, or yard sign for the owner's business: name, logo URL with pixel size and a low-resolution warning, services with formatted prices, phone, service area, booking link, QR image URL (PNG and SVG), the best two or three reviews as the booking page shows them (first name and last initial), before and after photo URLs already public on the booking page, and printFacts. Also returns small previews of the logo and photos so you can see them. Print rules: a door hanger is about 4.25 x 11 in with a die-cut hole; USPS EDDM postcards must meet the sizes in printFacts.eddmPostcard (a plain 4 x 6 does not qualify); federal law bars putting anything without postage in a mailbox, so door hangers go on doors; put the QR code and the link on every piece; if logo.lowResolutionWarning is set, say so before they print. Only works once the booking page is live. No arguments.

get_quote

Claude
Get one quote by UUID with its line items, customer contact, totals in cents, status timeline, public viewer URL, and any invoices made from it. Use after list_quotes. Requires a plan that includes quoting.

get_route

Claude
One Google Maps link that drives a day's remaining jobs and in-person quote visits in schedule order, starting from wherever the provider is, plus the stop list. Use for 'what's my route', directions for today or tomorrow, or mapping a day's jobs. Defaults to today on the provider's calendar; pass date (YYYY-MM-DD) for another day. Quote visits are on the route and marked quoteVisit: true; say which stops are quote visits. Finished and cancelled jobs are left out. Show googleMapsUrl as a link.

get_season_relaunch

Claude
Call this first when the owner asks about the slow or off season, getting ready for next season (spring, summer, fall), relaunching, or bringing back / reactivating / reaching out to past or old customers. Looks back 12 months and returns: lastSeason (which months were busy, jobs, customers, repeat customers), timing (when the season starts next and when to start reaching out), toReachOut (last season's customers with nothing booked yet, regulars first: first name, visits, last visit, last service, amount spent, months booked; no phone numbers), alreadyBooked (who is already on next season's schedule), otherContacts (CRM contacts with no job in the last year), the booking link, and doNow. Unlike get_growth_check, nobody is left out for being recent. Never invent customers, numbers or dates that are not here. No arguments.

get_vinny_activity

Claude
What Vinny (Village's AI assistant) finished recently, and how many Vinny tasks the provider has used this billing cycle versus their plan's allowance and extra credits.

list_crew

Claude
The provider's crew: id, name, phone, email, skills and default pay. Use the ids with get_crew_pay, list_crew_assignments and prepare_crew_change.

list_crew_assignments

Claude
Upcoming jobs with the crew on each one and whether they confirmed. Filter to one crew member. Flags jobs with no crew yet. Times are already in the provider's local time; show them as-is.

list_customers

Claude
List CRM customers for the authenticated provider. Search with q (name/email/phone). Pass lapseDays to find customers with no jobs yet or whose last job is older than N days; add bookedBefore=true to keep only people who have hired the business (win-back lists). Returns jobsCount, lastJobAt, totalCents. Paginated (max 25).

list_invoices

Claude
List invoices for the authenticated provider. Filter by status, createdAt (from/to), and dueAt (dueFrom/dueTo). Default sort is actionable (soonest due first) with isOverdue on each row. Includes amounts and public viewer URLs. Paginated (max 25). Requires a plan that includes invoicing.

list_jobs

Claude
List upcoming or past jobs (bookings) for the authenticated provider. Use when asked about schedule, this week, or upcoming work. Defaults to the next 14 days. Returns id, status, scheduledAt (exact instant), scheduledAtLocal (the provider's local time, already converted: show this one as-is), customer, service, and address, plus the provider's timezone. Paginated (max 25). Pass nextCursor for more pages. For quotes, use list_quotes instead of filtering jobs by quote status.

list_needs_you

Claude
The provider's Needs You queue, most urgent first, exactly as the Village dashboard ranks it: customer messages waiting on a reply, quotes and invoices that need a nudge, jobs needing details. Each item has a reason, the suggested action, whether Vinny can handle it, and a dashboard link. Use when asked what to do next or what needs attention.

list_quotes

Claude
List quotes (not bookings) for the authenticated provider. Filter by status (draft, sent, viewed, accepted, declined, expired). Pending snapshot count matches status sent+viewed. Includes amounts and public viewer URLs. Paginated (max 25). Requires a plan that includes quoting.

list_services

Claude
The provider's active service menu: services (pricing type, price in cents, unit, duration), packages, and add-ons. Use when asked what the business offers or charges.

prepare_crew_change

Claude
Step 1 of 2 for a crew change: mark crew pay as paid (specific jobs, or everything a person is owed), or add or remove a crew member on a job. Returns exactly what will change and a confirmationToken. Nothing changes yet. Show the preview to the owner and wait for an explicit yes before calling confirm_crew_change. Requires edit access.

prepare_send

Claude
Step 1 of 2 for messaging a customer: send a quote, send an invoice, or text a payment reminder for an unpaid invoice. Returns the exact text message, recipients, channels (text and/or email) and a confirmationToken. Nothing is sent. Always show the preview to the provider and wait for an explicit yes before calling confirm_send. Requires edit access.

save_business_setup

Claude
Save the confirmed answers from start_business_setup to the user's Village account: business name, about, services with prices, service area, weekly hours and business phone. Only fills what is empty: anything already set is left as is and listed under skipped. Adds services not already on the menu. For first setup only: to change something already set, use update_services, update_hours, update_service_area or update_page_text. Requires sign-in with edit access.

save_setup_draft

Claude
Hold the confirmed answers from start_business_setup, plus the pro's name, cell and email, until they verify their cell in Village's sign-in window. A new pro's account is then created with this setup. No sign-in needed, and nothing is sent: the sign-in code is only texted when the user asks for it in the sign-in window. Expires after 24 hours.

start_business_setup

Claude
Use when a home-service pro wants to set up Village or learn how it would run their business. Returns the topics Village needs to set up their account: business name, services and prices, specialties, service area, hours and phone. No account or sign-in needed to start. This tool saves nothing; follow nextSteps after the interview to save the answers and finish sign-up.

update_customer

Claude
Change a customer's name, email, phone or address. Only the fields passed are changed. Requires edit access.

update_draft

Claude
Edit a draft quote or invoice: customer, notes, valid-until or due date, a quote's job address, or replace its line items. Sent documents cannot be edited. Nothing is sent. Requires edit access.

update_hours

Claude
Replace the provider's weekly working hours, which set when customers can book. Send the whole week; days left out become days off. Use get_availability to see the current hours. Step 1 of 2: returns the exact changes and a confirmationToken. Nothing is saved. Show the changes to the provider and call confirm_page_update only after they say yes. Requires edit access.

update_page_text

Claude
Change the booking page headline (up to 200 characters) or description (up to 1000). Write in the provider's voice and read it back to them. Step 1 of 2: returns the exact changes and a confirmationToken. Nothing is saved. Show the changes to the provider and call confirm_page_update only after they say yes. Requires edit access.

update_service_area

Claude
Change where the provider works: the main area, the towns listed on the booking page, ZIP codes, and travel radius. Step 1 of 2: returns the exact changes and a confirmationToken. Nothing is saved. Show the changes to the provider and call confirm_page_update only after they say yes. Requires edit access.

update_services

Claude
Add, rename, reprice or remove services on the booking page. Prices are in cents. Use list_services first to see what is on the menu. A removed service with past jobs or quotes is archived, not deleted. Step 1 of 2: returns the exact changes and a confirmationToken. Nothing is saved. Show the changes to the provider and call confirm_page_update only after they say yes. Requires edit access.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/villagehomeservices"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/villagehomeservices)