[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

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

> 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 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
- Page: https://cotlet.dev/integrations/cleanmanager-api-mcp-server

## What can your AI agent do in CleanManager?

- 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

## Does CleanManager have an MCP server or an API?

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

| What you need | CleanManager integrations | By hand | Cotlet |
|---|---|---|---|
| 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](https://support.cleanmanager.com/en/integrations), [CleanManager pricing](https://cleanmanager.com/pricing), [Guide: Creating a task in the base calendar](https://support.cleanmanager.com/en/creating-a-task-in-the-base-calendar), [Guide: Cancelling a task](https://support.cleanmanager.com/en/cancelling-a-task), [Guide: Creating closing days](https://support.cleanmanager.com/en/creating-closing-days), [Guide: Converting tasks to absence hours](https://support.cleanmanager.com/en/how-do-i-convert-tasks-to-absence-hours), [Guide: Daily tasks in Check-in](https://support.cleanmanager.com/en/how-do-i-manage-daily-tasks-in-check-in), [Guide: Check-ins and check-outs](https://support.cleanmanager.com/en/view-check-ins-and-check-outs-as-the-administrator-supervisor), [Guide: Active alarms](https://support.cleanmanager.com/en/how-do-i-see-tasks-with-active-alarms-that-need-to-be-managed), [Guide: Photo documentation](https://support.cleanmanager.com/en/how-do-i-view-the-images-that-have-been-attached-to-tasks-via-the-app), [Guide: Creating a customer](https://support.cleanmanager.com/en/creating-a-customer), [Guide: Creating locations](https://support.cleanmanager.com/en/creating-locations), [Guide: Customer resources](https://support.cleanmanager.com/en/attaching-files-and-hyperlinks-to-a-customer), [Guide: Scheduled or used time](https://support.cleanmanager.com/en/setting-up-scheduled-used-time-on-a-service-agreement), [Guide: Sorting the view in Invoicing](https://support.cleanmanager.com/en/how-do-i-sort-the-view-in-invoicing), [Guide: Creating an employee](https://support.cleanmanager.com/en/creating-an-employee), [Guide: Employee workplaces](https://support.cleanmanager.com/en/viewing-employee-workplaces), [Guide: Wage profiles and hourly wages](https://support.cleanmanager.com/en/wage-profiles-and-hourly-wages), [Guide: Creating a cleaning plan](https://support.cleanmanager.com/en/creating-a-cleaning-plan-and-selecting-the-template-type-and-the-language), [Guide: Setting up a report template](https://support.cleanmanager.com/en/setting-up-a-new-report-template), [Guide: Filling out a report](https://support.cleanmanager.com/en/filling-out-a-report-as-an-administrator-or-a-supervisor), [Guide: Report statistics](https://support.cleanmanager.com/en/extracting-data-as-an-administrator-or-a-supervisor-statistics), [Guide: Sending messages](https://support.cleanmanager.com/en/sending-messages-as-an-administrator-supervisor), [Guide: Ordering and transferring products](https://support.cleanmanager.com/en/how-do-i-order-and-transfer-products-through-the-web-system), [Guide: Product requests](https://support.cleanmanager.com/en/how-do-i-handle-product-requests), [Guide: Setting up products](https://support.cleanmanager.com/en/setting-up-products)

## How does the CleanManager MCP server work?

1. **Sign in to CleanManager.** Once, in a browser we host for you.
2. **Connect your AI agent.** One address in its settings.
3. **Hand 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.

## How to connect CleanManager to your AI agent

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. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
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
```

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

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

- **Read the calendar** (`get_calendar`, read): Read scheduled tasks by day: customer, location, employees, time and status.
- **Create tasks** (`create_task`, write, asks first): Create a task in the calendar for a customer, location and service agreement, with employees and time.
- **Cancel tasks** (`cancel_task`, write, asks first): Cancel a task, or the repeats after it, and optionally notify the employees by e-mail.
- **Create closing days** (`create_closing_days`, write, asks first): Close one or more customers, or some of their locations, for a period, and cancel their tasks.
- **Register absence** (`register_absence`, write, asks first): Register an employee's absence and move their tasks to another employee as absence hours.

### Check-in

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

- **Read daily tasks** (`list_daily_tasks`, read): Read today's tasks in Check-in: not started, in progress and ended, with employee comments.
- **Approve or edit daily tasks** (`manage_daily_task`, write, asks first): Approve the hours on a daily task, or edit or delete it.
- **Read check-ins and check-outs** (`list_check_ins`, read): Read arrival and departure times, and whether each was registered by NFC tag or by hand.
- **Read active alarms** (`list_active_alarms`, read): Read the alarms for missing check-ins and check-outs.
- **Read photo documentation** (`get_photo_documentation`, read): List tasks with photos attached in the app, with the comments on each photo.

### Customers and invoicing

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

- **List customers** (`list_customers`, read): List customers with type, area, locations and service agreements, or export them as CSV.
- **Create and edit customers** (`manage_customer`, write, asks first): Create or edit a customer, add a location, or limit which products can be ordered for them.
- **Attach customer resources** (`add_customer_resource`, write, asks first): Attach a file or hyperlink to a customer, with a category and whether employees may see it.
- **Set service agreement billing** (`set_service_agreement_billing`, write, asks first): Set whether a service agreement invoices scheduled time or used time.
- **Read invoicing** (`get_invoicing`, read): Read the invoicing view for a period: tasks, fixed prices and item lines per customer.

### Employees and wages

Employees, groups, workplaces and wage profiles.

- **List employees** (`list_employees`, read): List employees with job title, employee group, user type and the workplaces they are linked to.
- **Create and edit employees** (`manage_employee`, write, asks first): Create or edit an employee, set their direct workplaces, or create an employee group.
- **Set wage profiles** (`manage_wage_profiles`, write, asks first): Create or edit a wage profile with hourly wages for work, transport, distance and absence, and assign it.

### Cleaning plans and quality reports

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

- **List cleaning plans** (`list_cleaning_plans`, read): List cleaning plans, for every customer or one, with template type and language.
- **Create cleaning plans** (`manage_cleaning_plan`, write, asks first): Create, name, copy or comment on a cleaning plan from a frequency, area, weekly or empty template.
- **Set up report templates** (`manage_report_template`, write, asks first): Create or edit a quality report template with parameter groups, parameters and rating options.
- **Fill out quality reports** (`fill_out_report`, write, asks first): Fill out a quality report for a customer location: ratings, comments and text fields.
- **Read completed reports** (`list_completed_reports`, read): Find completed quality reports by period, customer, employee, area, report type or who filled them out.
- **Read report statistics** (`get_report_statistics`, read): Read report scores over a period, sorted by customer, employee, area or employee group.

### Storage and messages

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

- **Read inventory** (`get_inventory`, read): Read stock per product in a storage, with the critical minimum and what is below it.
- **Handle product requests** (`handle_product_request`, write, asks first): List product requests from supervisors and employees, and approve or delete them.
- **Order and transfer products** (`order_or_transfer_products`, write, asks first): Order products for a customer location, or transfer them from a storage straight away.
- **Manage products, suppliers and stock** (`manage_storage_items`, write, asks first): Create, edit or delete products and suppliers, and set stock quantities and critical minimums.
- **Send e-mails and SMS** (`send_message`, write, asks first): Send an e-mail, or an SMS with the Text Messaging add-on, to employees and customer contacts.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/cleanmanager-api-mcp-server#tools

## 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](https://cotlet.dev/security.md)).

## What happens when CleanManager changes?

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.

## Approvals, undo and mistakes

1. **Read the calendar.** get_calendar returns the absent employee's tasks.
2. **Pick who covers.** The employee you name, or one the agent suggests from list_employees.
3. **Show you the move.** Days, tasks and the absence type, before anything is saved.
4. **Register after your OK.** register_absence converts the hours and moves the tasks.

| Action | How to put it right |
|---|---|
| Customer, location, employee or plan details | Call the same tool again with the earlier values |
| Cancelled task or closing day | The task stays in the calendar; create it again with create_task |
| Deleted product request | Gone for good: ask the employee to request again |
| E-mail or SMS | Already 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.

## How much does the CleanManager MCP server cost?

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

| Job | Calls | Credits |
|---|---|---|
| Morning alarms and tasks not started | 2 × 26 | 520 |
| Afternoon check-in review | 1 × 26 | 260 |
| Approve hours on daily tasks | 1 × 120 | 1,200 |
| Absence cover | 2 × 8 | 160 |
| Product requests and restocking | 2 × 14 | 280 |
| Quality reports from inspection notes | 1 × 20 | 200 |
| E-mails to employees and customers | 1 × 15 | 150 |
| Month-end statistics and invoicing check | 3 × 1 | 30 |
| Cloud Browser, 30 days |  | 1,500 |
| Total | 280 calls | 4,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.

## CleanManager MCP server: other ways to connect

| Option | What it does | Where it stops |
|---|---|---|
| Accounting integrations | Sync 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 import | Loads customers and employees from a CSV file. | One-way, at setup or in batches. |
| CSV exports | Customer, employee and report data for a spreadsheet, for the administrator. | A snapshot; nothing flows back. |
| By hand | A 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.

## Who runs Cotlet

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.

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.
