Klean CRM MCP server Let your AI agent run the Klean CRM office.

ToolWhat it doesAccess

• list_customers Customers, searchable by name, phone or address. read

  Returns customers with ID, address, next appointment and unpaid balance.

  MCP callklean_crm_read → list_customers

  REST endpointGET https://cotlet.dev/api/v1/klean-crm/customers

  Parameters

  Parameters: list_customers

  Name	Type	Description
  query string	string	Name, phone or street.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "customers": [
      {
        "customer_id": "KC-3310",
        "name": "Maria Johnson",
        "address": "2210 S Lamar Blvd, Austin, TX",
        "next": "2026-11-12",
        "unpaid": "0.00"
      }
    ],
    "page": 1
  }

• add_customer Adds a customer with an address. write

  Creates the customer. Reaches no one, so it runs at once.

  MCP callklean_crm_write → add_customer

  REST endpointPOST https://cotlet.dev/api/v1/klean-crm/customers

  Parameters

  Parameters: add_customer

  Name	Type	Description
  name string required	string	Customer name.
  address string required	string	Service address.
  phone string	string	Phone.
  email string	string	Email.

  Example input

  {
    "name": "Jane Doe",
    "address": "address"
  }

  Example response

  {
    "customer_id": "KC-3377",
    "name": "Tom Alvarez"
  }

ToolWhat it doesAccess

• list_appointments Cleaning appointments for a day or range, by cleaner. read

  Returns appointments with customer, address, cleaner, time and price.

  MCP callklean_crm_read → list_appointments

  REST endpointGET https://cotlet.dev/api/v1/klean-crm/appointments

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  date_from string required	string	ISO date.
  date_to string	string	ISO date. Default: date_from.
  cleaner string	string	Cleaner name.

  Example input

  {
    "date_from": "date from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "A-8812",
        "customer": "Maria Johnson",
        "cleaner": "Rosa",
        "start": "2026-11-12T09:00",
        "price": "160.00"
      }
    ]
  }

• book_appointment Books a cleaning on the calendar, once or recurring. writeasks first

  Creates the appointment with service, price and cleaner. Your Klean CRM text reminders then apply. By default you confirm each call; you can switch that off for this tool.

  MCP callklean_crm_write → book_appointment

  REST endpointPOST https://cotlet.dev/api/v1/klean-crm/customers/{customer_id}/appointments

  Parameters

  Parameters: book_appointment

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  start string required	string	ISO date and time.
  service string	string	Service name.
  price number	number	Price.
  cleaner string	string	Cleaner name.
  repeat string	string	Weekly, Every 2 weeks, Monthly or empty.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "start": "start"
  }

  Example response

  {
    "appointment_id": "A-8840",
    "customer": "Tom Alvarez",
    "cleaner": "Rosa",
    "start": "2026-11-13T10:00",
    "repeat": "Every 2 weeks"
  }

• assign_cleaner Assigns or changes the cleaner on an appointment. write

  Puts the cleaner on the job. Reaches only your team, so it runs at once.

  MCP callklean_crm_write → assign_cleaner

  REST endpointPOST https://cotlet.dev/api/v1/klean-crm/appointments/{appointment_id}/cleaner/assign

  Parameters

  Parameters: assign_cleaner

  Name	Type	Description
  appointment_id string required	string	Appointment ID.
  cleaner string required	string	Cleaner name.

  Example input

  {
    "appointment_id": "A-8812",
    "cleaner": "Lupe"
  }

  Example response

  {
    "appointment_id": "A-8812",
    "cleaner": "Lupe"
  }

ToolWhat it doesAccess

• send_invoice Creates and sends the invoice for a finished cleaning. writeasks first

  Invoices the appointment and sends it to the customer the way Klean CRM does. By default you confirm each call; you can switch that off for this tool.

  MCP callklean_crm_write → send_invoice

  REST endpointPOST https://cotlet.dev/api/v1/klean-crm/appointments/{appointment_id}/invoices

  Parameters

  Parameters: send_invoice

  Name	Type	Description
  appointment_id string required	string	Appointment ID.

  Example input

  {
    "appointment_id": "appointment_8c41d2"
  }

  Example response

  {
    "invoice_id": "INV-2209",
    "customer": "Maria Johnson",
    "total": "160.00",
    "status": "Sent"
  }

• list_unpaid_invoices Invoices not yet paid, oldest first. read

  Returns unpaid invoices with customer, total and days since sent.

  MCP callklean_crm_read → list_unpaid_invoices

  REST endpointGET https://cotlet.dev/api/v1/klean-crm/unpaid-invoices

  Parameters

  Parameters: list_unpaid_invoices

  Name	Type	Description
  min_days integer	integer	Only invoices sent at least this many days ago.

  Example response

  {
    "invoices": [
      {
        "invoice_id": "INV-2150",
        "customer": "Priya Shah",
        "total": "340.00",
        "days": 18
      }
    ]
  }