CleanManager API and MCP server Let your AI agent keep every cleaning round on track.

CleanManager publishes no API and no MCP server (checked 15 Nov 2026). Cotlet runs a hosted CleanManager MCP server with 29 tools that ChatGPT and Claude use in your own administrator or supervisor login. Calendar changes, messages and anything that touches wages wait for your OK.

  • Free 7-day trial, no card
  • Unofficial, not affiliated with CleanManager
CleanManager logo CleanManager Cloud Browser

29 tools Read and write

Cleaning operations

What can your AI agent do in CleanManager? The supervisor's day, from the first check-in to month-end.

  • Catch missed check-ins and check-outs

  • Move a sick employee's tasks

  • Add closing days for a customer

  • Approve product requests and restock

  • Fill out a quality report

  • Check invoicing before month-end

No API, no MCP

Does CleanManager have an MCP server or an API? The official CleanManager routes, checked 15 November 2026.

CleanManager publishes no developer API: its guide articles document integrations with accounting systems and CSV file import, and cleanmanager.com/api returns only a backend error. No CleanManager MCP server and no official ChatGPT or Claude connector was found.

  • CleanManager integrates with FreeAgent, Dynamics 365 Business Central, QuickBooks, Sage, Uniconta and Xero for customers and invoicing, plus file import.
  • There are no fixed plans: you build a subscription from the Base module and add-ons. CleanManager's own example is 195 € a month for 10 employees and 1 add-on module.
  • Add-on modules include App for Time & Attendance, Audits, Invoice Calculation, Wage Calculation, Text Messaging and Quote Calculation.
The CleanManager integrations, working by hand and Cotlet compared
What you need CleanManager integrationsBy handCotlet
Ask ChatGPT or Claude about today's rounds No API or MCP server Copy and paste Hosted MCP server
Customers, employees and invoices Synced with accounting In the web system 29 tools, writes after your OK
Calendar, check-in, plans, reports, storage Not covered One screen at a time Same tools, same key
Run from n8n or a script Nothing to call Manual only REST, same key

Checked 15 Nov 2026. Sources: CleanManager integrations · CleanManager pricing · Guide: Creating a task in the base calendar · Guide: Cancelling a task · Guide: Creating closing days · Guide: Converting tasks to absence hours · Guide: Daily tasks in Check-in · Guide: Check-ins and check-outs · Guide: Active alarms · Guide: Photo documentation · Guide: Creating a customer · Guide: Creating locations · Guide: Customer resources · Guide: Scheduled or used time · Guide: Sorting the view in Invoicing · Guide: Creating an employee · Guide: Employee workplaces · Guide: Wage profiles and hourly wages · Guide: Creating a cleaning plan · Guide: Setting up a report template · Guide: Filling out a report · Guide: Report statistics · Guide: Sending messages · Guide: Ordering and transferring products · Guide: Product requests · Guide: Setting up products

Set up once

How does the CleanManager MCP server work? The CleanManager MCP server by Cotlet: your agent works in your own CleanManager login.

  1. 1Sign in to CleanManager

    Once, in a browser we host for you.

  2. 2Connect your AI agent

    One address in its settings.

  3. 3Hand it the morning check

    Read the alarms, then approve each change.

Your agent works in your own signed-in Cloud Browser. Calendar changes, messages and wages wait for your OK. Who can see your session

Any MCP client

How to connect CleanManager to your AI agent

  1. 1

    Sign in to CleanManager in a Cloud Browser. Open cleanmanager.com/login in your Cotlet Cloud Browser and sign in with your CleanManager username and password, or with SSO.

  2. 2

    Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.

  3. 3

    Let the agent in. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

CleanManager sits on the shared address https://cotlet.dev/mcp/v1 with every other app you enable, so one connector covers them all. Turned CleanManager on after connecting? Refresh the connector and the 29 CleanManager tools appear.

ChatGPT
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
Claude
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
Cursor
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
Codex
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
n8n
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: cleanmanager_read
12 read, 17 write

All 29 CleanManager MCP tools

One tool per administrator or supervisor workflow in the CleanManager guide articles. Reads run at once; every write asks first. A supervisor login covers only its customer areas.

Calendar and absence5

Tasks are the basis for wages and invoicing, so the calendar comes first: tasks, cancellations, closing days and absence cover.

  • get_calendar Read scheduled tasks by day: customer, location, employees, time and status. read

    Reads Scheduling > Calendar. Cancelled tasks stay in the calendar, faded, and are marked so. Supervisors see only the customers in their assigned customer areas. Read only.

    MCP callcleanmanager_read → get_calendar

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/calendar

    Parameters

    Parameters: get_calendar
    NameTypeDescription
    from string string ISO date. Defaults to today.
    to string string ISO date. Defaults to the start date.
    customer string string One customer only.
    employee string string One employee only.

    Example response

    {
      "date": "2026-11-17",
      "tasks": [
        {
          "customer": "Example Offices Ltd",
          "location": "Head office",
          "employees": [
            "Employee A"
          ],
          "start": "06:00",
          "end": "08:30",
          "status": "scheduled"
        }
      ]
    }
  • create_task Create a task in the calendar for a customer, location and service agreement, with employees and time. writeAsks first

    Tasks are the basis for time registration, wages and invoicing in CleanManager, and they appear in the employee's workday in the app. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → create_task

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/tasks

    Parameters

    Parameters: create_task
    NameTypeDescription
    customer string required string Customer name, as list_customers returns it.
    location string required string A location of the customer.
    service_agreement string string The customer's service agreement, where agreements are in use.
    employees array array Employees to assign.
    date string required string ISO date.
    start string string HH:MM.
    end string string HH:MM.

    Example input

    {
      "customer": "customer",
      "location": "location",
      "date": "date"
    }

    Example response

    {
      "customer": "Example Offices Ltd",
      "location": "Head office",
      "date": "2026-11-24",
      "start": "06:00",
      "end": "08:30",
      "employees": [
        "Employee A"
      ],
      "created": true
    }
  • cancel_task Cancel a task, or the repeats after it, and optionally notify the employees by e-mail. writeAsks first

    A cancelled task stays in the calendar, faded out, but leaves payroll, invoicing and the employee's workday. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → cancel_task

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/task/cancel

    Parameters

    Parameters: cancel_task
    NameTypeDescription
    task string required string The task, by customer, location and date.
    which string string `just_this_task` (default) or the wider choices the calendar offers.
    notify string string `email` to tell the assigned employees, or leave empty.

    Example input

    {
      "task": "task"
    }

    Example response

    {
      "task": "Example School, Gym hall, 2026-11-20",
      "cancelled": true,
      "notified": [
        "Employee C"
      ]
    }
  • create_closing_days Close one or more customers, or some of their locations, for a period, and cancel their tasks. writeAsks first

    Used for school holidays and office closures. With `cancel_tasks` every task in the period leaves wages and invoicing. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → create_closing_days

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/closing-days

    Parameters

    Parameters: create_closing_days
    NameTypeDescription
    customers array required array Customers to close.
    skip_locations array array Locations that stay open.
    from string required string ISO date.
    to string required string ISO date.
    cancel_tasks boolean boolean Cancel every task in the period.
    notify boolean boolean Tell the employees about the cancellation.

    Example input

    {
      "customers": "customers",
      "from": "from",
      "to": "to"
    }

    Example response

    {
      "customers": [
        "Example School"
      ],
      "from": "2026-12-21",
      "to": "2027-01-01",
      "tasks_cancelled": 18,
      "notified": true
    }
  • register_absence Register an employee's absence and move their tasks to another employee as absence hours. writeAsks first

    Removing the employee from their tasks converts the planned working hours to absence hours, so wages stay right. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → register_absence

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/absences

    Parameters

    Parameters: register_absence
    NameTypeDescription
    employee string required string Who is absent.
    absence_type string required string One of your absence types, for example Sick.
    from string required string ISO date.
    to string required string ISO date.
    days number number Number of absence days; without it the absence shows only in the calendar, not in wages.
    transfer_to string string Employee who takes over the tasks.

    Example input

    {
      "employee": "Employee B",
      "absence_type": "Sick",
      "from": "2026-11-17",
      "to": "2026-11-18",
      "days": 2,
      "transfer_to": "Employee D"
    }

    Example response

    {
      "employee": "Employee B",
      "absence_type": "Sick",
      "from": "2026-11-17",
      "to": "2026-11-18",
      "days": 2,
      "tasks_moved": 4,
      "transfer_to": "Employee D"
    }

Check-in5

What happened on site: daily tasks, check-ins by NFC tag or by hand, alarms and photos from the app.

  • list_daily_tasks Read today's tasks in Check-in: not started, in progress and ended, with employee comments. read

    Check-in > Daily tasks shows which tasks employees have started and ended in the app. Supervisors see only the customers in their assigned customer areas. Read only.

    MCP callcleanmanager_read → list_daily_tasks

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/daily-tasks

    Parameters

    Parameters: list_daily_tasks
    NameTypeDescription
    date string string ISO date. Defaults to today.

    Example response

    {
      "date": "2026-11-17",
      "not_started": 4,
      "in_progress": 3,
      "ended": 11,
      "comments": [
        {
          "task": "Example Offices Ltd, Head office",
          "text": "Kitchen bin bags running low."
        }
      ]
    }
  • manage_daily_task Approve the hours on a daily task, or edit or delete it. writeAsks first

    Approved hours feed wages and invoicing. A deleted task leaves both. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → manage_daily_task

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/daily-task/manage

    Parameters

    Parameters: manage_daily_task
    NameTypeDescription
    action string required string One of `approve_hours`, `edit`, `delete`.
    task string required string The task, from list_daily_tasks.
    changes object object For `edit`: the new times or employees.

    Example input

    {
      "action": "action",
      "task": "task"
    }

    Example response

    {
      "task": "Example Offices Ltd, Head office, 2026-11-17",
      "approved_hours": 2.6,
      "approved": true
    }
  • list_check_ins Read arrival and departure times, and whether each was registered by NFC tag or by hand. read

    Shows each check-in and check-out as the employee registered it in the app: manually, with an NFC tag on the server, or offline and synced later. Read only.

    MCP callcleanmanager_read → list_check_ins

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/check-ins

    Parameters

    Parameters: list_check_ins
    NameTypeDescription
    from string string ISO date. Defaults to today.
    to string string ISO date. Defaults to the start date.
    employee string string One employee only.

    Example response

    {
      "check_ins": [
        {
          "employee": "Employee A",
          "location": "Head office",
          "arrival": "05:58",
          "departure": "08:34",
          "method": "nfc"
        },
        {
          "employee": "Employee B",
          "location": "Clinic wing",
          "arrival": "06:12",
          "method": "manual"
        }
      ]
    }
  • list_active_alarms Read the alarms for missing check-ins and check-outs. read

    Check-in > Active alarms lists every triggered alarm for no check-in or no check-out, so a supervisor sees a missed job before the customer calls. Read only.

    MCP callcleanmanager_read → list_active_alarms

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/active-alarms

    Parameters

    Parameters: list_active_alarms
    NameTypeDescription
    sort_by string string One of `customer`, `employee`, `area`, `employee_group`, with `show` naming which one.
    show string string The customer, employee, area or employee group to show.

    Example response

    {
      "alarms": [
        {
          "type": "no check-in",
          "employee": "Employee C",
          "customer": "Example School",
          "planned_start": "15:00"
        }
      ]
    }
  • get_photo_documentation List tasks with photos attached in the app, with the comments on each photo. read

    Photos sync as soon as the employee's phone is online, so they can appear before the task is ended. Supervisors see only the customers in their assigned customer areas. Read only.

    MCP callcleanmanager_read → get_photo_documentation

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/photo-documentation

    Parameters

    Parameters: get_photo_documentation
    NameTypeDescription
    from string string ISO date. Defaults to today.
    to string string ISO date. Defaults to the start date.
    customer string string One customer only.

    Example response

    {
      "tasks": [
        {
          "customer": "Example School",
          "location": "Gym hall",
          "date": "2026-11-16",
          "photos": 3,
          "comments": [
            "Floor finished, mats stacked."
          ]
        }
      ]
    }

Customers and invoicing5

Customers, locations, resources and service agreements, and the invoicing view. No tool sends an invoice.

  • list_customers List customers with type, area, locations and service agreements, or export them as CSV. read

    Only the administrator can export CSV; a supervisor gets the list. Supervisors see only the customers in their assigned customer areas. Read only.

    MCP callcleanmanager_read → list_customers

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/customers

    Parameters

    Parameters: list_customers
    NameTypeDescription
    search string string Part of a customer name.
    export string string `customers` or `locations` to get the administrator CSV export instead.

    Example response

    {
      "customers": [
        {
          "name": "Example Offices Ltd",
          "type": "Business",
          "area": "North",
          "locations": 2,
          "service_agreements": [
            "Weekly office cleaning"
          ]
        }
      ]
    }
  • manage_customer Create or edit a customer, add a location, or limit which products can be ordered for them. writeAsks first

    A location address turns on navigation in the employee app. Supervisors see only the customers in their assigned customer areas. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → manage_customer

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/customer/manage

    Parameters

    Parameters: manage_customer
    NameTypeDescription
    action string required string One of `create`, `update`, `add_location`, `set_products`.
    customer string required string Customer name.
    fields object object For `create` and `update`: type (Business or Private), CI no., area, calendar colour, contact person.
    location object object For `add_location`: name, address, ZIP code, city, country, floor space, name on invoices.
    products array array For `set_products`: the products allowed; empty means all.

    Example input

    {
      "action": "action",
      "customer": "customer"
    }

    Example response

    {
      "customer": "Example Offices Ltd",
      "location": {
        "name": "Warehouse",
        "address": "4 Example Road",
        "floor_space": 650
      },
      "saved": true
    }
  • add_customer_resource Attach a file or hyperlink to a customer, with a category and whether employees may see it. writeAsks first

    Instructions and site documents for a customer live here. Employees see a resource only when you say so. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → add_customer_resource

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/customer-resources

    Parameters

    Parameters: add_customer_resource
    NameTypeDescription
    customer string required string Customer name, as list_customers returns it.
    file_url string string A link the Cloud Browser can download: pdf, doc, docx, xls, xlsx, odt, ods, txt, png, gif or jpg.
    hyperlink string string A link to attach instead of a file.
    name string required string Name shown in CleanManager.
    category string string A resource category.
    employees_can_see boolean boolean Show it to employees in the app.

    Example input

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

    Example response

    {
      "customer": "Example Offices Ltd",
      "resource": "Site map",
      "category": "Instructions",
      "employees_can_see": true,
      "saved": true
    }
  • set_service_agreement_billing Set whether a service agreement invoices scheduled time or used time. writeAsks first

    Scheduled time bills the planned hours; used time bills the hours employees actually spent. It changes what the customer pays from then on. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → set_service_agreement_billing

    REST endpointPUT https://cotlet.dev/api/v1/cleanmanager/service-agreement-billing

    Parameters

    Parameters: set_service_agreement_billing
    NameTypeDescription
    customer string required string Customer name, as list_customers returns it.
    agreement string required string The service agreement.
    basis string required string One of `scheduled_time`, `used_time`.

    Example input

    {
      "customer": "customer",
      "agreement": "agreement",
      "basis": "basis"
    }

    Example response

    {
      "customer": "Example Offices Ltd",
      "agreement": "Weekly office cleaning",
      "basis": "used_time",
      "saved": true
    }
  • get_invoicing Read the invoicing view for a period: tasks, fixed prices and item lines per customer. read

    Filtering by billing interval keeps an agreement from being invoiced twice. Supervisors see only the customers in their assigned customer areas. Read only: the agent does not send invoices or export them to accounting.

    MCP callcleanmanager_read → get_invoicing

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/invoicing

    Parameters

    Parameters: get_invoicing
    NameTypeDescription
    from string required string ISO date, included.
    to string required string ISO date, included.
    billing_interval string string For example Monthly, so only those agreements show.
    show string string The customer, employee, area or employee group to show.

    Example input

    {
      "from": "from",
      "to": "to"
    }

    Example response

    {
      "period": "2026-11-01/2026-11-30",
      "billing_interval": "Monthly",
      "customers": [
        {
          "customer": "Example Offices Ltd",
          "agreement": "Weekly office cleaning",
          "lines": 5,
          "amount": 1840
        }
      ]
    }

Employees and wages3

Employees, groups, workplaces and wage profiles.

  • list_employees List employees with job title, employee group, user type and the workplaces they are linked to. read

    Workplaces are direct (set by hand) or indirect (from tasks in the calendar). Read only.

    MCP callcleanmanager_read → list_employees

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/employees

    Parameters

    Parameters: list_employees
    NameTypeDescription
    search string string Part of an employee name.
    export boolean boolean True for the administrator CSV export.

    Example response

    {
      "employees": [
        {
          "name": "Employee A",
          "job_title": "Cleaner",
          "group": "Morning team",
          "workplaces": {
            "direct": [
              "Example Offices Ltd"
            ],
            "indirect": [
              "Example School"
            ]
          }
        }
      ]
    }
  • manage_employee Create or edit an employee, set their direct workplaces, or create an employee group. writeAsks first

    Giving an employee access sends them into CleanManager with the user type you choose, so the agent shows you the fields first. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → manage_employee

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/employee/manage

    Parameters

    Parameters: manage_employee
    NameTypeDescription
    action string required string One of `create`, `update`, `set_workplaces`, `create_group`.
    employee string string Employee name.
    fields object object Job title, employee group, user type, app access, wage profile and contracted hours.
    workplaces array array For `set_workplaces`: customers the employee is linked to directly.
    group object object For `create_group`: group number and name. Administrator only.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "employee": "Employee D",
      "job_title": "Cleaner",
      "group": "Morning team",
      "workplaces": [
        "Example Offices Ltd"
      ],
      "saved": true
    }
  • manage_wage_profiles Create or edit a wage profile with hourly wages for work, transport, distance and absence, and assign it. writeAsks first

    Every account starts with the profile Hourly wage 1. A profile can step up its rates by months of employment. Wages are money, so every change waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → manage_wage_profiles

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/wage-profiles/manage

    Parameters

    Parameters: manage_wage_profiles
    NameTypeDescription
    action string required string One of `list`, `create`, `update`, `assign`. `list` only read.
    profile string string Wage profile name.
    rates array array Hourly wages by name and wage type.
    employees array array For `assign`.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "profile": "Cleaner, year two",
      "rates": [
        {
          "name": "Regular hours",
          "amount": 160
        }
      ],
      "assigned": [
        "Employee A"
      ]
    }

Cleaning plans and quality reports6

Plans shared with customers and employees, and the Audits add-on: templates, reports and statistics.

  • list_cleaning_plans List cleaning plans, for every customer or one, with template type and language. read

    Plans are shared with administrators, supervisors, customers and employees in the app and the web system. Supervisors see only the customers in their assigned customer areas. Read only.

    MCP callcleanmanager_read → list_cleaning_plans

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/cleaning-plans

    Parameters

    Parameters: list_cleaning_plans
    NameTypeDescription
    customer string string One customer only.

    Example response

    {
      "plans": [
        {
          "name": "Head office, weekly",
          "customer": "Example Offices Ltd",
          "template": "Weekly plan",
          "language": "English"
        }
      ]
    }
  • manage_cleaning_plan Create, name, copy or comment on a cleaning plan from a frequency, area, weekly or empty template. writeAsks first

    A finished plan is shared with the customer and the employees in the app, so the agent shows you the rows first. `copy` turns a standard plan into one for another customer. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → manage_cleaning_plan

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/cleaning-plan/manage

    Parameters

    Parameters: manage_cleaning_plan
    NameTypeDescription
    action string required string One of `create`, `update`, `copy`.
    plan string required string Cleaning plan name.
    customer string string The workplace the plan belongs to.
    template string string One of `frequency`, `area`, `weekly`, `empty`. Changing it later clears the plan.
    language string string Plan language, if not the system language.
    rows array array Headings and tasks in order.

    Example input

    {
      "action": "action",
      "plan": "plan"
    }

    Example response

    {
      "plan": "Warehouse, weekly",
      "customer": "Example Offices Ltd",
      "template": "weekly",
      "rows": 14,
      "saved": true
    }
  • manage_report_template Create or edit a quality report template with parameter groups, parameters and rating options. writeAsks first

    Part of the Audits add-on. Once a template has been used it is locked so its statistics stay true; `copy` makes an editable copy. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → manage_report_template

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/report-template/manage

    Parameters

    Parameters: manage_report_template
    NameTypeDescription
    action string required string One of `list`, `create`, `update`, `copy`. `list` only read.
    template string string Template name.
    customer string string All customers (administrator) or one customer.
    base string string Base template, for example Empty report or Quality report (compact).
    groups array array Parameter groups with their parameters and rating type: dropdown, checkbox or buttons.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "template": "Office audit",
      "customer": "All customers",
      "groups": 3,
      "locked": false,
      "saved": true
    }
  • fill_out_report Fill out a quality report for a customer location: ratings, comments and text fields. writeAsks first

    The agent records the ratings you give it; it does not inspect anything. The report counts in statistics and may be shared with the customer. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → fill_out_report

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/out-report/fill

    Parameters

    Parameters: fill_out_report
    NameTypeDescription
    customer string required string Customer name, as list_customers returns it.
    location string required string Customer location.
    template string required string Report template.
    employee string string The employee the report assesses.
    answers array required array Rating and comment per parameter, as given by you or the inspector.

    Example input

    {
      "customer": "customer",
      "location": "location",
      "template": "template",
      "answers": "answers"
    }

    Example response

    {
      "report": "Office audit",
      "customer": "Example Offices Ltd",
      "location": "Head office",
      "score": 88,
      "saved": true
    }
  • list_completed_reports Find completed quality reports by period, customer, employee, area, report type or who filled them out. read

    Reports come from the Audits add-on module. Returns each report with its score, customer, location and date. Read only.

    MCP callcleanmanager_read → list_completed_reports

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/completed-reports

    Parameters

    Parameters: list_completed_reports
    NameTypeDescription
    from string string ISO date. Defaults to today.
    to string string ISO date. Defaults to the start date.
    sort_by string string One of `customer`, `employee`, `area`, `employee_group`, with `show` naming which one.
    show string string The customer, employee, area or employee group to show.
    report_type string string A report type, or all.
    export boolean boolean True for a CSV export.

    Example response

    {
      "reports": [
        {
          "report": "Quality report (compact)",
          "customer": "Example Offices Ltd",
          "location": "Head office",
          "date": "2026-11-12",
          "score": 92
        }
      ]
    }
  • get_report_statistics Read report scores over a period, sorted by customer, employee, area or employee group. read

    The numbers behind the Reports > Statistics graph. Read only.

    MCP callcleanmanager_read → get_report_statistics

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/report-statistics

    Parameters

    Parameters: get_report_statistics
    NameTypeDescription
    from string required string ISO date.
    to string required string ISO date.
    sort_by string string One of `customer`, `employee`, `area`, `employee_group`, with `show` naming which one.
    show string string The customer, employee, area or employee group to show.

    Example input

    {
      "from": "from",
      "to": "to"
    }

    Example response

    {
      "period": "2026-10-01/2026-10-31",
      "by": "customer",
      "scores": [
        {
          "customer": "Example Offices Ltd",
          "average": 91
        },
        {
          "customer": "Example School",
          "average": 78
        }
      ]
    }

Storage and messages5

Stock, product requests, orders and transfers to sites, plus e-mails and SMS to employees and customer contacts.

  • get_inventory Read stock per product in a storage, with the critical minimum and what is below it. read

    Product numbers are your internal numbers, not the supplier's. Read only.

    MCP callcleanmanager_read → get_inventory

    REST endpointGET https://cotlet.dev/api/v1/cleanmanager/inventory

    Parameters

    Parameters: get_inventory
    NameTypeDescription
    storage string string Storage name. Defaults to the main storage.
    search string string Product number or name.

    Example response

    {
      "storage": "Main storage",
      "products": [
        {
          "number": "1001",
          "name": "Microfibre cloths",
          "quantity": 40,
          "critical_minimum": 50,
          "below_minimum": true
        }
      ]
    }
  • handle_product_request List product requests from supervisors and employees, and approve or delete them. writeAsks first

    A request shows order no., customer and location, who ordered, date, comment and products. Deleting a request removes it for good. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → handle_product_request

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/product-request/handle

    Parameters

    Parameters: handle_product_request
    NameTypeDescription
    action string required string One of `list`, `approve`, `delete`. `list` only read.
    request string string Order no. of the request.
    customer string string Filter by customer or area.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "requests": [
        {
          "order_no": "R-118",
          "customer": "Example School",
          "ordered_by": "Employee C",
          "products": [
            {
              "name": "Floor cleaner 5 L",
              "quantity": 2
            }
          ]
        }
      ]
    }
  • order_or_transfer_products Order products for a customer location, or transfer them from a storage straight away. writeAsks first

    An order can be transferred later; a transfer moves stock at once. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → order_or_transfer_products

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/or-transfer-products/order

    Parameters

    Parameters: order_or_transfer_products
    NameTypeDescription
    action string required string One of `order`, `transfer`.
    customer string required string Customer name, as list_customers returns it.
    location string required string Customer location.
    storage string string For `transfer`: the storage they leave.
    products array required array Product and quantity.
    comment string string Optional comment.

    Example input

    {
      "action": "action",
      "customer": "customer",
      "location": "location",
      "products": "products"
    }

    Example response

    {
      "action": "transfer",
      "customer": "Example Offices Ltd",
      "location": "Head office",
      "products": [
        {
          "name": "Microfibre cloths",
          "quantity": 20
        }
      ],
      "done": true
    }
  • manage_storage_items Create, edit or delete products and suppliers, and set stock quantities and critical minimums. writeAsks first

    Supervisors can manage storage only when the administrator allows it. A supplier with products cannot be deleted. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → manage_storage_items

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/storage-items/manage

    Parameters

    Parameters: manage_storage_items
    NameTypeDescription
    action string required string One of `create_product`, `update_product`, `delete_product`, `create_supplier`, `update_supplier`, `delete_supplier`, `set_quantity`.
    item string required string Product or supplier name.
    fields object object Product: product no., name, supplier, supplier product no., type, price. Supplier: name, address, CI/EAN no., phone, e-mail.
    quantity number number For `set_quantity`.
    critical_minimum number number For `set_quantity`.

    Example input

    {
      "action": "action",
      "item": "item"
    }

    Example response

    {
      "item": "Microfibre cloths",
      "quantity": 60,
      "critical_minimum": 50,
      "saved": true
    }
  • send_message Send an e-mail, or an SMS with the Text Messaging add-on, to employees and customer contacts. writeAsks first

    Messages go out only from the web version. CleanManager signs e-mails "With kind regards" and your name. They reach people at once. By default you confirm each call; you can switch that off for this tool.

    MCP callcleanmanager_write → send_message

    REST endpointPOST https://cotlet.dev/api/v1/cleanmanager/messages

    Parameters

    Parameters: send_message
    NameTypeDescription
    type string required string `email` or `sms`.
    recipients array required array Employees and customer contact persons.
    subject string string For e-mail.
    text string required string The message.
    copy_to_me boolean boolean Send a copy to your own e-mail.

    Example input

    {
      "type": "type",
      "recipients": "recipients",
      "text": "text"
    }

    Example response

    {
      "type": "email",
      "recipients": 6,
      "subject": "Holiday closing days",
      "sent": true
    }
Encrypted, revocable

Who can see my CleanManager session, and how do I revoke it?

  • What we store

    Your signed-in CleanManager browser profile, AES-256-GCM encrypted, in Finland. Never your password.

  • What your agent gets

    The 29 CleanManager tools. The session cookie stays in the Cloud Browser.

  • What the session sees

    What your user type sees: everything for an administrator, the assigned customer areas for a supervisor.

  • What no tool touches

    Your subscription and add-on modules, the accounting integrations, company structure settings and NFC tag setup.

  • If CleanManager signs you out

    You sign in again yourself, in the same Cloud Browser.

  • How to cut access

    Disable CleanManager for agents, reset the browser, or change your CleanManager password.

Cotlet never sees or stores your password. You type it yourself, or sign in with SSO, and the agent only uses the session that sign-in leaves behind. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

We keep it working

What happens when CleanManager changes? The tools work through the same web system your supervisors use.

CleanManager offers two calendar views, the calendar and the base calendar, and its guides cover both. Cotlet watches the apps it serves and updates the CleanManager server when screens like these change, so your agent keeps working without a change on your side.

Add-on modules appear to the agent when your subscription has them: Audits for quality reports, Text Messaging for SMS.

If CleanManager signs you out, one click in the Cotlet console reopens the Cloud Browser so you can sign in again.

17 tools ask first

Approvals, undo and mistakes Employees, customers and wages change only when you say so.

  1. 01 Read the calendar get_calendar returns the absent employee's tasks.
  2. 02 Pick who covers The employee you name, or one the agent suggests from list_employees.
  3. 03 Show you the move Days, tasks and the absence type, before anything is saved.
  4. 04 Register after your OK register_absence converts the hours and moves the tasks.
Fixing a CleanManager write that went wrong
ActionHow to put it right
Customer, location, employee or plan detailsCall the same tool again with the earlier values
Cancelled task or closing dayThe task stays in the calendar; create it again with create_task
Deleted product requestGone for good: ask the employee to request again
E-mail or SMSAlready sent: send a correction

All 17 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 12 read tools run at once.

MCP call
{
  "name": "register_absence",
  "arguments": {
    "employee": "Employee B",
    "absence_type": "Sick",
    "from": "2026-11-17",
    "to": "2026-11-18",
    "days": 2,
    "transfer_to": "Employee D"
  }
}
REST
curl -X POST https://cotlet.dev/api/v1/cleanmanager/absences \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"employee":"Employee B","absence_type":"Sick","from":"2026-11-17","to":"2026-11-18","days":2,"transfer_to":"Employee D"}'
Response
{
  "employee": "Employee B",
  "absence_type": "Sick",
  "from": "2026-11-17",
  "to": "2026-11-18",
  "days": 2,
  "tasks_moved": 4,
  "transfer_to": "Employee D"
}

The example registers two sick days and moves four tasks to another employee as absence hours, so wages stay right. A cron job or n8n flow can make the same call over REST at /api/v1/cleanmanager with the same key and price, in JSON. Failed calls are free.

Pay per call

How much does the CleanManager MCP server cost?

About $25 a monthfor a cleaning company with about 25 employees and 30 customers, 4,300 credits. Your CleanManager subscription stays as it is.

Illustrative month, our assumption: successful calls for this workload
JobCallsCredits
Morning alarms and tasks not started2 × 26520
Afternoon check-in review1 × 26260
Approve hours on daily tasks1 × 1201,200
Absence cover2 × 8160
Product requests and restocking2 × 14280
Quality reports from inspection notes1 × 20200
E-mails to employees and customers1 × 15150
Month-end statistics and invoicing check3 × 130
Cloud Browser, 30 days1,500
Total280 calls4,300

The smallest pack, 5,000 credits for $29, covers this month. More sites and more approvals use more calls.

  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Your CleanManager modules apply as they are

Credit packs are one-time purchases, not a subscription. The month above is an example built from our own assumptions, not measured customer usage.

Cotlet credit packs: price, credits and calls at 10 credits each
Credits Price, one time Calls at 10 credits Per 1,000 credits
5,000 $29 500 $5.80
15,000 $79 1,500 $5.27
32,000 $149 3,200 $4.66
60,000 $249 6,000 $4.15

Only successful calls use credits; failed calls and timeouts cost nothing. At a balance of 0 calls pause, never a surprise charge. Authenticate with the Authorization: Bearer header.

Other options

CleanManager MCP server: other ways to connect What each route does for a cleaning company, and where it stops.

Other ways to work with CleanManager, checked 15 Nov 2026
OptionWhat it doesWhere it stops
Accounting integrationsSync customers and employees, and export invoicing to FreeAgent, Business Central, QuickBooks, Sage, Uniconta or Xero.Accounting data only; no calendar, check-in or storage.
File importLoads customers and employees from a CSV file.One-way, at setup or in batches.
CSV exportsCustomer, employee and report data for a spreadsheet, for the administrator.A snapshot; nothing flows back.
By handA supervisor works through the web system.One screen at a time, between site visits.

For bookkeeping, use the CleanManager integrations: they are the vendor's own route. Cotlet fits when you want ChatGPT, Claude or a script to watch check-ins, rearrange the calendar and handle storage in CleanManager itself, from your own login, with nothing to host.

EU company, since 2019

Who runs Cotlet A company you can look up.

Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and in business since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the CleanManager tools.

CleanManager MCP server: questions

How do I get access?

Sign up free at https://cotlet.dev/signup?app=cleanmanager, turn on CleanManager under Integrations in the console and sign in at https://cleanmanager.com/login in your Cloud Browser. Then connect your AI agent and ask about today's tasks. The trial needs no card.

Does CleanManager have an API?

CleanManager publishes no developer API: its guide articles document accounting and payroll integrations and CSV file import, and cleanmanager.com/api returns only a backend error, not documentation (checked 15 Nov 2026). No CleanManager MCP server and no official ChatGPT or Claude connector was found. Cotlet does not need one: it works in your own signed-in CleanManager account.

Do I need CleanManager add-on modules for every tool?

No. Calendar, check-in, customers, cleaning plans and storage are in the Base module. Quality reports need the Audits add-on and SMS needs Text Messaging; those tools work when your subscription has them.

Can a supervisor login use the tools?

Yes, within the supervisor's customer areas, as in CleanManager itself. Some actions, such as CSV exports, employee groups and storage administration without permission, are for the administrator only.

Which CleanManager user should I sign in with?

An administrator for the whole company, or a supervisor for their customer areas. Your CleanManager username is generated from your company name and your client or staff number.

Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 29 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

Is Cotlet affiliated with CleanManager?

No. Cotlet is independent and not affiliated with CleanManager.

Hand tomorrow morning's CleanManager check to your agent.

Free 7-day trial with 2,000 credits, no card needed.