Skip to content
MCP server

MaidCentral MCP by usefulapi

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

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About MaidCentral MCP by usefulapi

MaidCentral MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

claude mcp add --transport http maidcentral https://maidcentral.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://maidcentral.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "maidcentral": {
      "url": "https://maidcentral.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "maidcentral": {
      "type": "http",
      "url": "https://maidcentral.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (20)

Read directly from the server.

maidcentral_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.
maidcentral_list_scopes
List the scopes of work (and frequencies) of one scope group. API: GET /api/Lead/Scopes.
maidcentral_list_scope_frequencies
List the frequency options (one-time, weekly, ...) of one scope. API: GET /api/Lead/ScopeFrequencies.
maidcentral_list_questions
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.
maidcentral_list_rate_modifications
List the extras, discounts and other rate modifications available for a scope group. API: GET /api/Lead/RateModifications.
maidcentral_list_available_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.
maidcentral_list_postal_codes
List the postal codes the company serves, with their home zone. API: GET /api/Lead/PostalCodes.
maidcentral_list_customer_sources
List customer (lead) sources. API: GET /api/Lead/CustomerSources.
maidcentral_list_billing_terms
List billing terms usable when booking. API: GET /api/Lead/BillingTerms.
maidcentral_list_teams
List teams that jobs can be scheduled to. API: GET /api/Lead/Teams.
maidcentral_list_tags
List tags with their category ids (lead tags = category 8, service set tags = 5, first job tags = 6). API: GET /api/Lead/Tags.
maidcentral_list_note_types
List note types (Email = 1, Note = 2, PhoneCall = 3, TextMessage = 4). API: GET /api/Note/Types.
maidcentral_get_lead
Get a lead by id: contact details, status, source, scope group and addresses. API: GET /api/Lead/Lead.
maidcentral_get_quote
Get a quote by id: status, addresses, and per-scope and per-frequency prices, hours and booked state. API: GET /api/Lead/Quote.
maidcentral_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.
maidcentral_create_or_update_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.
maidcentral_create_or_update_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.
maidcentral_book_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.
maidcentral_create_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.
maidcentral_add_utm_data
WRITE: attach UTM campaign data to a lead or quote. Give lead_id, email or phone. API: POST /api/Lead/Utm.

MaidCentral MCP by usefulapi FAQ

How do I add MaidCentral MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http maidcentral https://maidcentral.usefulapi.io/mcp