ZenMaid MCP Server and API by Cotlet

dev.cotletPublished by cotlet.devOfficial publisherv1.0.2Updated Nov 11, 2026

ZenMaid cleaning business scheduling MCP server: create appointment, reschedule appointment.

The publisher's own server: Cotlet

VerifiedStreamable HTTPWeb executableProductivity & Workflow Business & Commerce

Server details

Identifier: dev.cotlet/zenmaid
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Nov 11, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to cotlet.dev, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/dev.cotlet%2Fzenmaid.svg)](https://sourceweft.com/mcp/dev.cotlet%2Fzenmaid?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Hosted Cotlet.dev MCP server that lets an AI assistant schedule and reschedule appointments in a ZenMaid cleaning-business account.

What you can do: Create and reschedule appointments, including recurring jobs for new or existing customers
Find open slots for a given service length and list them by day
Add and update customer records with addresses and recurring schedules
Review recurring customers with no upcoming jobs and their last clean date
Reassign a staff member's jobs to another and list affected customers
When to use it: Useful if you run a cleaning business on ZenMaid and want to book, move or audit jobs and customers by asking in plain language instead of clicking through the app.
Requirements: Remote endpoint at cotlet.dev over streamable HTTP, or a local stdio server via the zenmaid-mcp PyPI package (Python 3.10+) or Docker. Needs a Cotlet API key sent as an Authorization Bearer header, or the COTLET_API_KEY environment variable for the local server. A signed-in ZenMaid account connected through Cotlet.dev is required.

Before you install

The Authorization header carries a Cotlet API key that grants access to your ZenMaid account; keep it secret. Tools can create and change appointments and customer records, so confirm before bulk moves or edits. Requests and account data pass through the third-party Cotlet.dev service, which acts inside your ZenMaid account.

Installation

In SourceWeft

Open ZenMaid MCP Server and API by Cotlet in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.cotlet%2Fzenmaid/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "zenmaid-and-api-by-cotlet": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/zenmaid/connect"
    }
  }
}

README

How to connect ZenMaid to Claude Code, ChatGPT and any AI agent

Yes, Claude, ChatGPT and other AI agents can work in your ZenMaid account. ZenMaid has no official app in the ChatGPT or Claude directories, and its documentation points integrations to Zapier. Cotlet.dev connects your own signed-in ZenMaid account to any AI agent, so you can ask in plain words and the AI schedules jobs, finds openings and updates customers for you.

What you can ask

Schedule a 3-hour deep clean for Maria Lopez at 42 Oak Street on Thursday at 9 am with Team B.

Where are the open slots next week for a 2-hour standard clean? List them by day.

Add a new customer, David Chen at 18 Pine Ave, with a biweekly clean every other Monday at 1 pm.

Which recurring customers have no job booked in the next 30 days? Show their last clean date.

Move all of Kelly's Friday jobs to Rosa and list the customers affected.

Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.

Claude Code

bash

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

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

ChatGPT

Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.

Cursor

Copy .cursor/mcp.json from this repo into your project:

json

{  "mcpServers": {    "cotlet": {      "url": "https://cotlet.dev/mcp/v1",      "headers": {        "Authorization": "Bearer ${COTLET_API_KEY}"      }    }  }}

{  "mcpServers": {    "cotlet": {      "url": "https://cotlet.dev/mcp/v1",      "headers": {        "Authorization": "Bearer ${COTLET_API_KEY}"      }    }  }}

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its ZenMaid tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

json

{"mcpServers":{"zenmaid":{"command":"uvx","args":["zenmaid-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

{"mcpServers":{"zenmaid":{"command":"uvx","args":["zenmaid-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

Or with Docker:

Tools: zenmaid_guide, zenmaid_status, zenmaid_open, zenmaid_read, zenmaid_click, zenmaid_type, zenmaid_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

Command line

Python 3.10+, nothing else to install. From PyPI:

Or straight from this repo:

bash

export COTLET_API_KEY="your-key"python3 zenmaid_agent.py connect   # ready config for Claude Code, Cursor, ChatGPTpython3 zenmaid_agent.py status    # is ZenMaid ready in your Cotlet.dev accountpython3 zenmaid_agent.py guide     # ZenMaid screens and sign-in linkpython3 zenmaid_agent.py read      # open ZenMaid, read the page, close the browserpython3 zenmaid_agent.py tools     # list Cotlet.dev toolspython3 zenmaid_agent.py serve     # start the stdio MCP server (same as no argument)

export COTLET_API_KEY="your-key"python3 zenmaid_agent.py connect   # ready config for Claude Code, Cursor, ChatGPTpython3 zenmaid_agent.py status    # is ZenMaid ready in your Cotlet.dev accountpython3 zenmaid_agent.py guide     # ZenMaid screens and sign-in linkpython3 zenmaid_agent.py read      # open ZenMaid, read the page, close the browserpython3 zenmaid_agent.py tools     # list Cotlet.dev toolspython3 zenmaid_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from ZenMaid users

Does ZenMaid have an API?

ZenMaid's documentation directs integrations through Zapier. Cotlet.dev works in your ZenMaid account directly, so your AI agent can schedule jobs and manage customers without setting up Zaps.

How do I connect ZenMaid to ChatGPT?

Add Cotlet.dev as an app in ChatGPT (Settings → Apps, connector URL https://cotlet.dev/mcp/v1), sign in to ZenMaid once in your Cotlet.dev Cloud Browser, and ask ChatGPT in plain words. No code and no ZenMaid API key.

Is there a way to use Claude with ZenMaid?

Yes. In Claude Code run the one-line claude mcp add command above; in the Claude app add https://cotlet.dev/mcp/v1 as a custom connector. Claude then works in your own ZenMaid account.

Is there a ZenMaid MCP server?

ZenMaid has no official MCP server. Zapier offers a third-party ZenMaid MCP connection. Cotlet.dev is a hosted MCP server that works in ZenMaid for you, 24/7, with Claude, ChatGPT, Cursor, Codex, n8n, Make and Zapier.

Find it on

Also works with

More: https://cotlet.dev/integrations/zenmaid-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=zenmaid

Start free: https://cotlet.dev/signup?app=zenmaid&utm_source=github&utm_medium=readme&utm_campaign=zenmaid

Source: README.md at commit 2f38dc8

Tools

SourceWeft has not read this server's tools yet.

Version history

v1.0.2LatestNov 11, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Business & CommerceNot indexed yetNov 11, 2026