Skip to main content
Glama
README.md
# Sweepivo MCP server for ChatGPT, Claude and AI agents

Sweepivo publishes no public API and no official MCP server, according to the [Cotlet.dev Sweepivo page](https://cotlet.dev/integrations/sweepivo-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=sweepivo), checked 15 November 2026. Cotlet.dev provides a hosted Sweepivo MCP server with 10 tools for cleaning bookings, cleaner assignments, unpaid visits, payroll and business reports in your own signed-in account.

Connect Sweepivo to ChatGPT, Claude, Codex and Claude Code through your Cotlet Cloud Browser. This repository supplies an optional Python stdio bridge and CLI for the hosted service. It requires a Cotlet account; it does not run Sweepivo locally.

## Connect your account

1. [Sign up for Cotlet.dev](https://cotlet.dev/signup?app=sweepivo).
2. Open Sweepivo in your Cotlet Cloud Browser and sign in as an owner or manager at https://sweepivo.com/signin using your emailed code or passkey.
3. In ChatGPT or Claude, add `https://cotlet.dev/mcp/v1/connect` and complete the Cotlet authorization.
4. In editors and scripts, use `https://cotlet.dev/mcp/v1` with an API key from the Cotlet console.

For Claude Code:

```sh
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```

For Codex:

```toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

The included `mcp.json` configures the hosted connection. Supply your key through the environment and keep it out of version control.

## What can your agent do?

The live page lists 7 read operations and 3 write operations:

| Operation | What it does | Access |
|---|---|---|
| `view_daily_tasks` | Read visits and items needing attention | Read |
| `assign_cleaners` | Assign or reassign cleaners to a visit | Write, asks first |
| `view_cleaning_bookings` | Read cleaning bookings | Read |
| `view_booking_answers` | Read clients' booking answers | Read |
| `share_booking_link` | Read the shareable booking link | Read |
| `track_customer_payments` | Read customer payments and unpaid visits | Read |
| `review_cleaner_payroll` | Read cleaner earnings for a pay period | Read |
| `view_business_reports` | Read revenue, labour cost and services booked | Read |
| `set_service_prices` | Change service prices, extras or minimums | Write, asks first |
| `create_cleaning_website` | Add, edit or publish cleaning website pages | Write, asks first |

Confirm the current operation names and parameters on the live page. Hosted tools group these operations under `sweepivo_read` and `sweepivo_write`. The optional bridge exposes shared Cotlet helper tools; its local tool count is different from the app operation count.

Writes request confirmation by default; you can change approval settings per tool. Payroll requires the Sweepivo Shine plan or above. Reads do not charge cards, send payment reminders or start a pay run.

## Example requests

> Show tomorrow's uncovered visits and new bookings.

> List unpaid visits, largest first.

> Compare cleaner pay with revenue for the last pay period.

> Show me the cleaner reassignment before saving it.

## Optional Python bridge

Python 3.10 or later is required. The bridge uses the Python standard library.

```sh
python sweepivo_agent.py --help
python sweepivo_agent.py serve
```

Set `COTLET_API_KEY` before making authenticated calls. The bridge forwards calls to Cotlet.dev; sign-in happens in the hosted Cloud Browser.

## Frequently asked questions

**Does Sweepivo have an official ChatGPT or Claude connector?**

The source page reports none found as of 15 November 2026. Sweepivo AI is its in-product receptionist and route planner, rather than an external agent connector.

**How does passwordless sign-in work?**

You enter the emailed code or use your passkey yourself in the Cloud Browser. Your agent then uses the signed-in session.

**Does a cleaner login work for office tasks?**

Use an owner or manager session. Payments, payroll and business reports require the corresponding account access and plan.

**Where are the current setup instructions and prices?**

See the [Sweepivo integration page](https://cotlet.dev/integrations/sweepivo-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=sweepivo) for the current tool descriptions, connection instructions and Cotlet pricing. Your Sweepivo plan remains separate.

Unofficial. Cotlet.dev is independent and is not affiliated with Sweepivo or Ziontech Solutions LLC.