TIDY — AI Property Management Platform

TIDY is an AI-powered property management platform. This skill provides complete access to all TIDY capabilities: property management, cleaning scheduling, guest reservations, maintenance tasks, service professionals, and a natural language AI assistant.

Base URL: https://public-api.tidy.com
Interactive API docs: https://public-api.tidy.com/docs
MCP endpoint: INLINECODE2

Quick Start

The fastest way to interact with TIDY is the CLI or the natural language message-tidy endpoint.

CLI Quick Start

CODEBLOCK0

API Quick Start

CODEBLOCK1

---

Authentication

Sign Up

CODEBLOCK2

Log In

CODEBLOCK3

Both return: { "token": "abc123..." }. Tokens do not expire.

Use Authorization: Bearer <token> on all subsequent requests.

CLI Authentication

CODEBLOCK4

Credentials are stored at ~/.config/tidy/credentials. Set TIDY_API_TOKEN as an environment variable to override stored credentials.

---

MCP Server

TIDY exposes an MCP (Model Context Protocol) server for use with Claude Desktop, Claude Code, Cursor, and any MCP client.

Endpoint: https://public-api.tidy.com/mcp (Streamable HTTP, POST)

Available MCP Tools

Tool	Auth Required	Description
INLINECODE8	No	Authenticate with email/password
INLINECODE9

No | Create account | | message_tidy | Yes | Send natural language request (async) | | get_message_tidy | Yes | Poll for async message result | | list_messages_tidy | Yes | List all previous messages | | list_addresses | Yes | List all managed properties | | create_address | Yes | Add a new property | | get_address | Yes | Get property details | | update_address | Yes | Update a property | | delete_address | Yes | Remove a property | | list_bookings | Yes | List cleaning jobs | | create_booking | Yes | Schedule a cleaning | | get_booking | Yes | Get job details | | update_booking | Yes | Modify a job | | cancel_booking | Yes | Cancel a job | | reschedule_booking | Yes | Reschedule a job | | list_booking_availabilities | Yes | Find available time slots | | list_guest_reservations | Yes | List guest stays | | create_guest_reservation | Yes | Create a guest stay | | get_guest_reservation | Yes | Get reservation details | | delete_guest_reservation | Yes | Cancel a guest stay | | list_tasks | Yes | List maintenance issues | | create_task | Yes | Report a maintenance issue | | get_task | Yes | Get task details | | update_task | Yes | Update a task | | delete_task | Yes | Remove a task | | list_to_do_lists | Yes | List cleaning checklists | | create_pro | Yes | Add a service professional |

Connect from Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

CODEBLOCK5

Connect from Claude Code

CODEBLOCK6

Stdio Proxy (for clients that only support stdio)

CODEBLOCK7

MCP Async Workflow

INLINECODE37 is asynchronous:

1. 1. Call login or signup to get a token
2. Call message_tidy with your request in plain English
3. Note the returned INLINECODE41
4. Poll get_message_tidy with that ID every 3–5 seconds
5. When status is completed, read response_message for the result

---

Message TIDY (Natural Language AI)

Send any property management request in plain English and TIDY's AI handles it.

Send a message

CODEBLOCK8

Parameters:

• - message (required): natural language request
• INLINECODE47 (optional): { address_id, booking_id, issue_id, guest_reservation_id } to scope the request
• INLINECODE49 (optional): JSON Schema describing desired structured response format

Status values: queued → in_progress → completed or INLINECODE53

Poll for result

CODEBLOCK9

Poll every 3–5 seconds. When status is completed, the answer is in response_message.

List all messages

CODEBLOCK10

---

Addresses (Properties)

Method	Path	Description
GET	INLINECODE57	List all addresses
GET

/api/v2/addresses/:id | Get address details |
| POST | /api/v2/addresses | Create an address |
| PUT | /api/v2/addresses/:id | Update an address |
| DELETE | /api/v2/addresses/:id | Delete an address |

Create an address

CODEBLOCK11

Required: address, city, postal_code, parking (with paid_parking, parking_spot, parking_notes).

Optional: unit, country_code (default "US"), address_name, notes (with access, closing).

parking_spot values: myspot, meter, street, guest, paidlot.

parking_pay_with values: card, cash (default "card").

---

Jobs (Cleaning Bookings)

Method	Path	Description
GET	INLINECODE86	List all jobs
GET

/api/v2/jobs/:id | Get job details |
| POST | /api/v2/jobs | Create a job |
| PUT | /api/v2/jobs/:id | Update a job |
| POST | /api/v2/jobs/:id/cancel | Cancel a job |
| POST | /api/v2/jobs/:id/reschedule | Reschedule a job |

Service Types

Key	Description
INLINECODE92	1-hour regular cleaning
INLINECODE93

2.5-hour regular cleaning | | regular_cleaning.four_hours | 4-hour regular cleaning | | deep_cleaning.two_and_a_half_hours | 2.5-hour deep cleaning | | deep_cleaning.four_hours | 4-hour deep cleaning | | turnover_cleaning.two_and_a_half_hours | 2.5-hour turnover cleaning | | turnover_cleaning.four_hours | 4-hour turnover cleaning |

Booking Statuses

INLINECODE99 → in_progress → completed or cancelled or INLINECODE103

Create a job

CODEBLOCK12

Required: address_id, service_type_key, start_no_earlier_than (date + time), end_no_later_than (date + time).

Optional: preferred_start_datetime, to_do_list_id.

Cancel a job

CODEBLOCK13

Reschedule a job

CODEBLOCK14

---

Booking Availability

CODEBLOCK15

Required: address_id, service_type_key.

---

Guest Reservations

Method	Path	Description
GET	INLINECODE112	List reservations (optional address_id filter)
GET

/api/v2/guest-reservations/:id | Get reservation details |
| POST | /api/v2/guest-reservations | Create a reservation |
| DELETE | /api/v2/guest-reservations/:id | Delete a reservation |

Create a reservation

CODEBLOCK16

Required: address_id, check_in.date, check_out.date.

Optional: check_in.time, check_out.time.

---

Tasks (Maintenance / Issues)

Method	Path	Description
GET	INLINECODE122	List tasks (filter by address_id, status, type, urgency, assigned_to_concierge)
GET

/api/v2/tasks/:id | Get task details |
| POST | /api/v2/tasks | Create a task |
| PUT | /api/v2/tasks/:id | Update a task |
| DELETE | /api/v2/tasks/:id | Delete a task |

Task Statuses

INLINECODE132 → in_progress → INLINECODE134

Task Urgency Levels

INLINECODE135, normal, high, INLINECODE138

Create a task

CODEBLOCK17

Required: address_id, title, description, type.

Optional: status, urgency, due_date, assigned_to_concierge.

---

To-Do Lists

CODEBLOCK18

---

Service Professionals (Pros)

CODEBLOCK19

Required: name, email. Optional: phone, service_types.

---

CLI Reference

Install

CODEBLOCK20

Commands

CODEBLOCK21

Environment Variables

Variable	Description	Default
INLINECODE151	API base URL	INLINECODE152
INLINECODE153

Bearer token (overrides stored credentials) | — |

---

Complete API Endpoint Reference

Method	Path	Description
POST	INLINECODE154	Create account
POST

/api/v2/auth/login | Log in | | POST | /api/v2/message-tidy | Send AI message (async) | | GET | /api/v2/message-tidy/:id | Poll message result | | GET | /api/v2/message-tidy | List messages | | GET | /api/v2/addresses | List addresses | | POST | /api/v2/addresses | Create address | | GET | /api/v2/addresses/:id | Get address | | PUT | /api/v2/addresses/:id | Update address | | DELETE | /api/v2/addresses/:id | Delete address | | GET | /api/v2/jobs | List jobs | | POST | /api/v2/jobs | Create job | | GET | /api/v2/jobs/:id | Get job | | PUT | /api/v2/jobs/:id | Update job | | POST | /api/v2/jobs/:id/cancel | Cancel job | | POST | /api/v2/jobs/:id/reschedule | Reschedule job | | GET | /api/v2/guest-reservations | List reservations | | POST | /api/v2/guest-reservations | Create reservation | | GET | /api/v2/guest-reservations/:id | Get reservation | | DELETE | /api/v2/guest-reservations/:id | Delete reservation | | GET | /api/v2/tasks | List tasks | | POST | /api/v2/tasks | Create task | | GET | /api/v2/tasks/:id | Get task | | PUT | /api/v2/tasks/:id | Update task | | DELETE | /api/v2/tasks/:id | Delete task | | GET | /api/v2/to-do-lists | List to-do lists | | POST | /api/v2/pros | Add a pro | | GET | /api/v2/booking-availabilities | Check availability |

Full interactive documentation: https://public-api.tidy.com/docs

---

Date and Time Formats

• - Dates: YYYY-MM-DD (e.g., 2026-04-10)
• Times: HH:MM 24-hour format (e.g., 09:00, 17:30)
• Date-time fields use nested objects: INLINECODE188

---

Error Handling

All errors return:

CODEBLOCK22

HTTP Status	Error Type	When
400	INLINECODE189	Missing or invalid parameters
401

authentication_error | Bad credentials or missing token |
| 404 | not_found_error | Resource does not exist |
| 500 | internal_error | Server error |

---

Detailed Reference Documentation

• - Authentication — token lifecycle, storage, MCP auth
• MCP Server Reference — full tool definitions, async pattern, setup
• REST API Reference — complete endpoint documentation with parameters

Related Skills

• - cleaning-maintenance — focused on booking cleanings and managing maintenance
• vacation-rental-management — focused on Airbnb/VRBO turnovers and guest reservations