Tidy MCP server

Connect Tidy to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy TidyBook a demo

What you can do with the Tidy MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the create job tool in Tidy
  • Use the create address tool in Tidy
  • Use the delete guest reservation tool in Tidy
  • Use the cancel job tool in Tidy
  • Use the reschedule job tool in Tidy
  • Use the update address tool in Tidy

Supported Tools

create_job

Create Job

Schedule a new cleaning or maintenance job at a property. Specify the address, service type, and a preferred time window. Optionally attach a to-do list defining what tasks should be completed.

create_address

Create Address

Add a new property address to your TIDY account. Addresses are the foundational entity for scheduling jobs, assigning pros, and managing to-do lists. You can include access notes and parking information.

delete_guest_reservation

Delete Guest Reservation

Delete a guest reservation. This removes the reservation record but does not affect any associated jobs that have already been created.

cancel_job

Cancel Job

Cancel a scheduled job. Once cancelled, the job cannot be reactivated; you would need to create a new job instead.

reschedule_job

Reschedule Job

Reschedule an existing job with a new time window and optionally a new service type. Use this for major schedule changes. For minor adjustments, use the "Update Job" tool.

update_address

Update Address

Update an existing property address. You can modify the address name, access notes, closing notes, and parking details. The street address, unit, postal code, and country code cannot be changed after creation.

add_pro

Add Pro

Add a service professional to your TIDY priority list. Pros are cleaning or maintenance professionals who can be assigned to jobs at your properties.

resolve_issue

Resolve Issue

Mark a property issue as resolved. Changes the issue status from "open" to "resolved".

get_issue

Get Issue

Retrieve detailed information about a specific property issue by its ID.

create_guest_reservation

Create Guest Reservation

Create a new guest reservation at a property. Reservations are linked to addresses and help coordinate cleaning around guest check-in and check-out schedules. Default check-in time is 14:00 and check-out time is 11:00.

list_addresses

List Addresses

List all property addresses associated with your TIDY account. Returns addresses sorted by creation date. Use this to find address IDs needed for creating jobs, reservations, or issues.

list_jobs

List Jobs

List all cleaning or maintenance jobs. Optionally filter by address, status, or to-do list. Use this to monitor job progress across your properties.

delete_address

Delete Address

Remove a property address from your TIDY account. The address cannot be deleted if it has active jobs associated with it.

get_guest_reservation

Get Guest Reservation

Retrieve detailed information about a specific guest reservation, including check-in/check-out dates and times, and any associated job.

list_todo_lists

List To-Do Lists

List active to-do lists that define tasks to be completed during jobs. Optionally filter by address. To-do list IDs can be used when creating or updating jobs to specify what work should be done.

get_job

Get Job

Retrieve detailed information about a specific job by its ID, including status, scheduling, pricing, and assigned to-do list.

list_guest_reservations

List Guest Reservations

List all guest reservations for your properties. Optionally filter by address. Useful for managing short-term rental turnovers and coordinating cleaning around guest schedules.

check_booking_availability

Check Booking Availability

Query available time slots for booking a job at a specific address. Returns availability for the next 4 weeks. Use this before creating a job to find a suitable time window.

list_issues

List Issues

List property issues across your addresses. Optionally filter by address or status (open/resolved). Use this to track damage reports and low inventory alerts.

update_job

Update Job

Make minor updates to an existing job, such as adjusting the time window or changing the to-do list. For major schedule changes, use the "Reschedule Job" tool instead.

delete_issue

Delete Issue

Permanently delete a property issue record.

get_address

Get Address

Retrieve detailed information about a specific property address by its ID, including location details, access notes, and parking information.

create_issue

Create Issue

Report a new property issue such as damage or low inventory at a specific address. Issues can be tracked and resolved over time.

message_tidy

Send Request to Tidy

Send a natural-language property management request to TIDY. Requests can schedule cleanings, report issues, or coordinate property services and may change your account.

Connect Tidy to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Tidy in Metorial. In your Metorial portal, enable the Tidy MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Tidy tools.

Run Tidy through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Tidy and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Tidy tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Tidy

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Technical notes for Tidy

Manage properties, book and schedule cleaning and maintenance jobs, and coordinate service professionals through the TIDY property management platform. Create and manage property addresses, request and schedule jobs with preferred time windows, assign and manage service pros, track booking availability, manage to-do lists for job tasks, handle guest reservations for short-term rentals, and report and resolve property issues.

Frequently asked questions

Common questions about connecting Tidy to AI agents with Metorial.

  1. How many tools does the Tidy MCP server have?
    The Tidy MCP server exposes 24 tools, including Create Job, Create Address, Delete Guest Reservation. Each one is governed and traced through Metorial.
  2. Tidy exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Tidy MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Tidy and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Tidy MCP server yourself or use the hosted gateway.

Connect Tidy to production AI agents

See how Metorial gives your team governed access to Tidy, with tracing and security controls built in.

Book a demoDeploy Tidy