MaidCentral MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

Read services, prices and open dates; create leads, quotes, bookings and notes in MaidCentral.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & Workflow Business & Commerce

Server details

Identifier: io.usefulapi/maidcentral
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Nov 1, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to usefulapi.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Fmaidcentral.svg)](https://sourceweft.com/mcp/io.usefulapi%2Fmaidcentral?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Connects an assistant to a MaidCentral cleaning-company account to read services, prices and open dates, and to create leads, quotes, bookings and notes.

What you can do: Browse the service catalog: scope groups, scopes of work, frequencies, pricing questions, rate modifications, postal codes, customer sources, billing terms, teams, tags and note types
Check availability and price jobs: list bookable dates for a given length or amount, and calculate a price without storing anything
Look up records: fetch a lead or a quote by id
Create and change records: create or update leads and quotes, book a quote into a customer with a first job, add notes, and attach UTM campaign data
Manage the subscription: check monthly usage, request a missing feature, upgrade or cancel a plan
When to use it: Useful for cleaning-company staff or resellers who want an assistant to answer pricing and availability questions, draft quotes, and enter leads and bookings in MaidCentral without opening the app.
Requirements: Remote hosted endpoint; no local install. Connect with the server URL only, then sign in through OAuth with the username and password of a MaidCentral API user (created by an Administrator under Company settings, Integrations). No API key or Authorization header goes in the client config. A free plan allows 50 tool calls per month; paid plans are billed per user.

Before you install

Write tools create or update leads and quotes, book quotes into customers, add notes and UTM data, and can trigger emails, campaigns and webhooks; the lead tool sends email, adds to campaigns and fires webhooks by default unless disabled, and booking emails follow the vendor setting. Your MaidCentral credentials are stored per user by the third-party host. Paid plans involve payment links and subscriptions with no refund for the current period.

Installation

In SourceWeft

Open MaidCentral MCP by usefulapi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fmaidcentral/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "maidcentral-by-usefulapi": {
      "type": "http",
      "url": "https://maidcentral.usefulapi.io/mcp"
    }
  }
}

README

MaidCentral MCP by usefulapi

Use your MaidCentral account from Claude, Cursor, or any MCP client. Read the service types, pricing questions, rates and open job dates of your cleaning company. Also create leads, quotes, bookings and notes. Hosted, no local install: connect with your own credentials.

Live endpoint: https://maidcentral.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://maidcentral.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http maidcentral https://maidcentral.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

json

{  "mcpServers": {    "maidcentral": {      "url": "https://maidcentral.usefulapi.io/mcp"    }  }}

{  "mcpServers": {    "maidcentral": {      "url": "https://maidcentral.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your MaidCentral credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/maidcentral/

On first connect you enter the username and password of a MaidCentral API user (Company → Settings → General → Integrations, as an Administrator). The server validates it and stores it per user. No keys go in config files.

Tools

Tool	Type	What it does
`maidcentral_list_scope_groups`	read	List scope groups
`maidcentral_list_scopes`	read	List scopes of a scope group
`maidcentral_list_scope_frequencies`	read	List frequencies of a scope
`maidcentral_list_questions`	read	List pricing questions for scopes
`maidcentral_list_rate_modifications`	read	List rate modifications
`maidcentral_list_available_dates`	read	List available job dates
`maidcentral_list_postal_codes`	read	List serviceable postal codes
`maidcentral_list_customer_sources`	read	List customer sources
`maidcentral_list_billing_terms`	read	List billing terms
`maidcentral_list_teams`	read	List teams
`maidcentral_list_tags`	read	List tags
`maidcentral_list_note_types`	read	List note types
`maidcentral_get_lead`	read	Get a lead
`maidcentral_get_quote`	read	Get a quote
`maidcentral_calculate_price`	read	Calculate price
`maidcentral_create_or_update_lead`	write	Create or update a lead
`maidcentral_create_or_update_quote`	write	Create or update a quote
`maidcentral_book_quote`	write	Book a quote
`maidcentral_create_note`	write	Create a note
`maidcentral_add_utm_data`	write	Add UTM data to a lead
`maidcentral_usage_status`	meta	Usage status (free-tier meter)
`maidcentral_request_feature`	meta	Request a missing feature
`maidcentral_upgrade`	meta	Upgrade to Pro or Pro+
`maidcentral_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with maidcentral_upgrade (it returns a Stripe Checkout link). Cancel any time with maidcentral_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running maidcentral_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/maidcentral/README.md at commit 4046075

Tools

maidcentral_list_scope_groups

List scope groups

List service categories (scope groups) with their scopes of work and frequency ids. Start here: the ids feed quotes, pricing and bookings. API: GET /api/Lead/ScopeGroups.

Takes no parameters.

maidcentral_list_scopes

List scopes of a scope group

List the scopes of work (and frequencies) of one scope group. API: GET /api/Lead/Scopes.

Parametersscope_group_idrequired

maidcentral_list_scope_frequencies

List frequencies of a scope

List the frequency options (one-time, weekly, ...) of one scope. API: GET /api/Lead/ScopeFrequencies.

Parametersscope_idrequired

maidcentral_list_questions

List pricing questions for scopes

List the questions (home size, bedrooms, ...) and answer options for one or more scopes. Required questions must be answered in quotes and pricing. API: GET /api/Lead/Questions.

Parametersscope_idsrequired

maidcentral_list_rate_modifications

List rate modifications

List the extras, discounts and other rate modifications available for a scope group. API: GET /api/Lead/RateModifications.

Parametersscope_group_idrequired

maidcentral_list_available_dates

List available job dates

List dates on which a quoted job of a given length or price can be booked for a scope group. Give hours or amount. API: GET /api/Lead/Availability.

Parametershoursamountend_datestart_datescope_group_idrequired

maidcentral_list_postal_codes

List serviceable postal codes

List the postal codes the company serves, with their home zone. API: GET /api/Lead/PostalCodes.

Takes no parameters.

maidcentral_list_customer_sources

List customer sources

List customer (lead) sources. API: GET /api/Lead/CustomerSources.

Takes no parameters.

maidcentral_list_billing_terms

List billing terms

List billing terms usable when booking. API: GET /api/Lead/BillingTerms.

Takes no parameters.

maidcentral_list_teams

List teams

List teams that jobs can be scheduled to. API: GET /api/Lead/Teams.

Takes no parameters.

maidcentral_list_note_types

List note types

List note types (Email = 1, Note = 2, PhoneCall = 3, TextMessage = 4). API: GET /api/Note/Types.

Takes no parameters.

maidcentral_get_lead

Get a lead

Get a lead by id: contact details, status, source, scope group and addresses. API: GET /api/Lead/Lead.

Parameterslead_idrequired

maidcentral_get_quote

Get a quote

Get a quote by id: status, addresses, and per-scope and per-frequency prices, hours and booked state. API: GET /api/Lead/Quote.

Parametersquote_idrequired

maidcentral_calculate_price

Calculate price

Calculate a price for scopes, frequencies, extras and question answers without creating a lead or quote. Stores nothing. API: POST /api/Lead/CalculatePrice.

Parametersquestionsrequiredpostal_codescope_group_idrequiredscopes_of_workrequired

maidcentral_create_or_update_lead

Create or update a lead

WRITE: create a lead, or update one when lead_id is given. The postal code must be in a home zone. By default MaidCentral may send the lead email, add the lead to campaigns and trigger webhooks: set send_lead_email, add_to_campaigns and trigger_webhook to false to avoid that. Without allow_duplicates, a matching contact links to the existing lead. API: POST /api/Lead/CreateOrUpdate.

Parametersemailrequirednotesphonerequiredlead_idutm_termlast_namerequiredfirst_namerequiredutm_mediumutm_sourcepostal_coderequiredutm_contentlead_tag_ids+6 more

maidcentral_create_or_update_quote

Create or update a quote

WRITE: create a quote for a lead (or update one when quote_id is given) with service address, scopes, frequencies and question answers. Optionally emails the quote 5 minutes later (send_quote_email, default false). API: POST /api/Lead/CreateOrUpdateQuote.

Parameterslead_idrequiredquote_idhome_cityrequiredquestionsrequiredhome_regionrequiredbilling_cityhome_address1requiredhome_address2billing_regionscope_group_idrequiredscopes_of_workrequiredtrigger_webhook+6 more

maidcentral_book_quote

Book a quote

WRITE: convert a quote into a customer and schedule the first job on first_job_date. Check dates with maidcentral_list_available_dates first. Booking emails default to the vendor setting: set send_booked_email and send_customer_portal_invite to false to stay silent. API: POST /api/Lead/BookQuote.

Parameterslead_idrequiredquote_idrequiredscope_group_idrequiredscopes_of_workrequiredtrigger_webhookadd_to_campaignsbilling_terms_idsend_booked_emailsend_customer_portal_invite

maidcentral_create_note

Create a note

WRITE: add a note (or logged email, call, text) to a quote, customer or employee. Give entity_id with entity_type_id, or entity_contact_info (email or phone). API: POST /api/Note/Create.

Parameterscontentrequiredsubjectentity_idnote_type_idcreate_ticketentity_type_identity_contact_infocommunication_direction_id

maidcentral_add_utm_data

Add UTM data to a lead

WRITE: attach UTM campaign data to a lead or quote. Give lead_id, email or phone. API: POST /api/Lead/Utm.

Parametersemailphonelead_idutm_termutm_mediumutm_sourceutm_contentutm_campaign

Version history

v1.3.4LatestNov 7, 2026
v1.2.3Nov 5, 2026
v1.2.2Nov 5, 2026
v1.2.1Nov 4, 2026
v1.2.0Nov 3, 2026
v1.1.1Nov 3, 2026
v1.0.0Nov 1, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts