# MaidCentral MCP by usefulapi

> MaidCentral MCP by usefulapi is an MCP server. Read services, prices and open dates; create leads, quotes, bookings and notes in MaidCentral. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/maidcentral/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/maidcentral
- **MCP Registry name:** io.usefulapi/maidcentral
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://maidcentral.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/maidcentral-mcp-by-usefulapi
