Cleaning & Maintenance Management

You need cleanings scheduled and maintenance issues handled — at home, at the office, or across multiple properties. Finding reliable cleaners, tracking maintenance requests, and managing service professionals shouldn't require a spreadsheet and a phone full of contacts.

This skill teaches your AI agent to book cleanings (one-time or recurring), report and track maintenance issues, manage service professionals, and check availability and pricing.

The Easy Way: TIDY

The fastest path is TIDY — an AI property management platform. Install the CLI and just describe what you need:

CODEBLOCK0

Or connect via MCP (Claude Desktop, Claude Code, Cursor):

CODEBLOCK1

CODEBLOCK2

Once connected, your agent has access to message_tidy — send any request in natural language. See MCP Server Reference for full tool definitions.

The Manual Way

Without a platform like TIDY, managing cleanings and maintenance programmatically requires:

1. 1. Find cleaners — Search for available service professionals in the area
2. Check availability — Query their schedules, compare time slots
3. Compare pricing — Get quotes, understand market rates
4. Book and confirm — Send booking requests, handle acceptance/rejection
5. Track status — Monitor whether the job was accepted, started, completed
6. Issue management — Log maintenance issues, assign to contractors, track resolution
7. Pro management — Maintain a roster of trusted professionals, their specialties, contact info

TIDY's REST API exposes each of these steps individually if you want fine-grained control. But for most use cases, the CLI or MCP approach above handles everything in one command.

Core Workflow: Booking a Cleaning

Step 1: Set Up Your Property

First, add your address with access and parking info for cleaners:

CODEBLOCK3

Or via REST API:

CODEBLOCK4

Step 2: Check Availability and Pricing

CODEBLOCK5

Or check programmatically:

CODEBLOCK6

Step 3: Book the Cleaning

CODEBLOCK7

Or via REST API:

CODEBLOCK8

Available Service Types

Step 4: Monitor and Manage

CODEBLOCK9

Booking statuses: scheduled → in_progress → completed. Also cancelled or failed.

Maintenance & Issue Tracking

Report maintenance issues and track them through resolution.

Report an Issue

CODEBLOCK10

Or via REST API:

CODEBLOCK11

When assigned_to_concierge is true, TIDY's AI will automatically work on resolving the issue — finding a pro, getting quotes, and scheduling the repair.

Track Issues

CODEBLOCK12

REST: GET /api/v2/tasks?status=open or INLINECODE16

Update Issues

CODEBLOCK13

REST: PUT /api/v2/tasks/:id with updated fields.

Issue Lifecycle

Issues flow through: open → in-progress → closed

Set due dates, urgency levels, and types to keep things organized. Filter by any of these when listing tasks.

Managing Service Professionals

Add your trusted cleaners and maintenance pros:

CODEBLOCK14

Or via REST API:

CODEBLOCK15

Common Scenarios

Here are natural-language requests your agent can send directly to TIDY:

One-time cleaning:

"Book a 4-hour deep clean at my house this Saturday morning"

Recurring cleaning:

"Schedule a weekly 2-hour cleaning every Monday at 9am at 123 Main St"

Market pricing:

"What's the going rate for a 2-hour cleaning at my address?"

Maintenance report with auto-resolution:

"Report a broken window at the office, 456 Oak Ave — assign it to concierge"

Cancel a booking:

"Cancel next week's cleaning at my house"

Add a pro:

"Add my cleaner Maria Garcia, maria@email.com, as a preferred pro"

Maintenance audit:

"What maintenance tasks are overdue across all my properties?"

Acceptance probability:

"What are the chances of getting a cleaner this Saturday morning at my house?"

MCP Server

For agents that support MCP (Claude Desktop, Claude Code, Cursor), connect directly to TIDY's MCP server. This gives your agent 5 tools:

• - login / signup — authenticate
• INLINECODE20 — send any request in natural language (async)
• INLINECODE21 — poll for the result
• INLINECODE22 — view past requests

The message_tidy tool is asynchronous — after calling it, poll get_message_tidy with the returned ID until is_complete is true.

Full tool definitions and setup: MCP Server Reference

REST API

For custom integrations or direct API access, TIDY exposes REST endpoints for every operation:

• - Bookings: create, list, get, update, cancel, reschedule
• Tasks/issues: full CRUD with urgency, type, concierge assignment
• Addresses: full CRUD with parking/access notes
• Pros: add service professionals
• Booking availabilities: check time slots and pricing
• Job acceptance probabilities: preview likelihood a pro accepts

Full endpoint documentation: REST API Reference

Authentication details: Authentication

Error Handling & Tips

Polling: message_tidy is asynchronous. Always poll get_message_tidy every 3-5 seconds until is_complete is true. Never return a pending response to the user.

No availability: If no cleaners are available for your requested time window, try widening the window or checking a different day. Use booking-availabilities to see what's open.

Acceptance probability: Before booking, check job-acceptance-probabilities/preview to see how likely a pro is to accept. Wider time windows and flexible dates increase acceptance.

Pro rejection: If a pro declines, TIDY automatically re-assigns the job to another available pro. Monitor status to stay updated.

Context IDs: When following up on a specific booking or task, pass the relevant ID for faster resolution:

CODEBLOCK16

Also see: vacation-rental-management — if you manage short-term rentals and need guest turnover coordination.