MCP Server Setup

TIDY's MCP (Model Context Protocol) server lets any MCP-compatible AI agent connect to TIDY and manage cleaning, maintenance, and guest turnovers. Your agent discovers TIDY's capabilities automatically through MCP's tool discovery protocol.

Prerequisites

• Node.js 18 or later
• A TIDY account and API token (see Authentication)

Claude Code

Run this command in your terminal:

claude mcp add tidy -- npx @tidyapp/mcp-server

Set your token as an environment variable before starting Claude Code:

export TIDY_API_TOKEN=your-api-token

Claude Desktop

Add this to your Claude Desktop configuration file (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "tidy": {
      "command": "npx",
      "args": ["@tidyapp/mcp-server"],
      "env": {
        "TIDY_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cursor

Add this to your Cursor MCP settings (Settings > MCP):

{
  "mcpServers": {
    "tidy": {
      "command": "npx",
      "args": ["@tidyapp/mcp-server"],
      "env": {
        "TIDY_API_TOKEN": "your-api-token"
      }
    }
  }
}

Codex CLI

codex mcp add tidy -- npx @tidyapp/mcp-server

VS Code (GitHub Copilot)

Create or add to .vscode/mcp.json in your project:

{
  "servers": {
    "tidy": {
      "command": "npx",
      "args": ["@tidyapp/mcp-server"],
      "env": {
        "TIDY_API_TOKEN": "your-api-token"
      }
    }
  }
}

Windsurf

Add this to your Windsurf MCP settings:

{
  "mcpServers": {
    "tidy": {
      "command": "npx",
      "args": ["@tidyapp/mcp-server"],
      "env": {
        "TIDY_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

The MCP server exposes these tools, which are automatically discovered by your agent:

Testing Your Connection

After setting up the MCP server, test it by asking your agent:

"Use the TIDY MCP server to list my addresses"

If you don't have any addresses yet, try:

"Use TIDY to add a new address at 123 Main St, Miami FL 33101"

Troubleshooting

Connection errors

Make sure TIDY_API_TOKEN is set in your environment or in the MCP configuration's env block. The token must be a valid Bearer token from POST /v1/customer/login.

Tools not appearing

Restart your agent after adding the MCP configuration. Some agents require a full restart to pick up new MCP servers.

Rate limiting

The MCP server respects TIDY API rate limits. If you see rate limit errors, wait a moment and retry. The message_tidy endpoint processes requests asynchronously, so polling may be needed for long-running operations.