Vagaro MCP tools

MCP tool vagaro_list_locations

Returns every location of your Vagaro business. Use location_id from each item in the other calls. Multi-location businesses read one location per call.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_list_locations",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "locations": [
      {
        "location_id": "loc_21",
        "name": "Main Street",
        "address": "120 Main St, Portland, OR",
        "time_zone": "America/Los_Angeles",
        "phone": "+1 555 0100"
      },
      {
        "location_id": "loc_22",
        "name": "Riverside",
        "address": "8 River Rd, Portland, OR",
        "time_zone": "America/Los_Angeles",
        "phone": "+1 555 0101"
      }
    ]
  },
  "isError": false
}

MCP tool vagaro_list_services

Returns the services of one location with duration, price and the providers who perform them. Use service_id in search_availability and book_appointment. Prices are the menu prices shown in Vagaro.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_list_services",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "services": [
      {
        "service_id": "svc_1172",
        "name": "Balayage",
        "duration_min": 150,
        "price": {
          "amount": 185,
          "currency": "USD"
        },
        "provider_ids": [
          "emp_309"
        ]
      },
      {
        "service_id": "svc_1180",
        "name": "Women's cut",
        "duration_min": 45,
        "price": {
          "amount": 65,
          "currency": "USD"
        },
        "provider_ids": [
          "emp_309",
          "emp_311"
        ]
      }
    ]
  },
  "isError": false
}

MCP tool vagaro_list_appointments

Returns appointments of one location between two days, ordered by start time. Filter by provider to read one person's day. Each item has the client, service, provider, status and price shown on the calendar. This reads the calendar by date, which the official API cannot do.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_list_appointments",
    "arguments": {
      "from": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "appointments": [
      {
        "appointment_id": "apt_7730301",
        "client": "Maya Brooks",
        "service": "Women's cut",
        "provider": "Alex",
        "start": "2026-10-14T09:00:00-07:00",
        "end": "2026-10-14T09:45:00-07:00",
        "status": "Booked"
      },
      {
        "appointment_id": "apt_7730415",
        "client": "Jamie Cole",
        "service": "Balayage",
        "provider": "Alex",
        "start": "2026-10-14T11:30:00-07:00",
        "end": "2026-10-14T14:00:00-07:00",
        "status": "Booked"
      }
    ]
  },
  "isError": false
}

MCP tool vagaro_search_availability

Returns open start times for one service in a date range, per provider. Use a start from the result in book_appointment or reschedule_appointment so the booking lands on a free slot.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_search_availability",
    "arguments": {
      "service_id": "service_8c41d2",
      "from": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "slots": [
      {
        "provider_id": "emp_309",
        "provider": "Alex",
        "start": "2026-10-15T10:00:00-07:00"
      },
      {
        "provider_id": "emp_309",
        "provider": "Alex",
        "start": "2026-10-15T14:30:00-07:00"
      }
    ]
  },
  "isError": false
}

MCP tool vagaro_find_client

Searches your customers by name, email or phone and returns contact details and tags. Use client_id in book_appointment and add_to_waitlist. The official API needs a customer ID up front; this finds the ID from what you know.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_find_client",
    "arguments": {
      "query": "query"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "clients": [
      {
        "client_id": "cl_48213",
        "name": "Jamie Cole",
        "email": "jamie@example.com",
        "phone": "+1 555 0142",
        "tags": [
          "color"
        ]
      }
    ]
  },
  "isError": false
}

MCP tool vagaro_list_waitlist

Returns the waitlist of one location. Each entry has the client, the service and provider they asked for and the day. Use entry IDs in notify_waitlist. Which alerts Vagaro sends on its own depends on your waitlist mode under Online Appointment Rules.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_list_waitlist",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "entries": [
      {
        "waitlist_entry_id": "wl_2041",
        "client": "Maya Brooks",
        "service": "Women's cut",
        "provider": "Alex",
        "date": "2026-10-14"
      },
      {
        "waitlist_entry_id": "wl_2044",
        "client": "Sam Ortiz",
        "service": "Beard trim",
        "provider": "any",
        "date": "2026-10-14"
      }
    ]
  },
  "isError": false
}

MCP tool vagaro_list_conversations

Returns your Connect chats with clients, most recent first, with the last message and whether it is unread. Set unread_only to see what needs an answer. Replies to appointment notifications do not appear here.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_list_conversations",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversations": [
      {
        "conversation_id": "cv_2290",
        "client": "Maya Brooks",
        "unread": true,
        "last_message": "How much is a cut with Alex?",
        "updated_at": "2026-10-13T16:02:00-07:00"
      }
    ]
  },
  "isError": false
}

MCP tool vagaro_list_reviews

Returns the reviews posted on your Vagaro listing page, newest first, with rating, text and whether you replied. Use unanswered_only to skip reviews you already answered. You cannot remove a customer review in Vagaro, so this tool only reads them.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_list_reviews",
    "arguments": {
      "location_id": "loc_21",
      "since": "2026-10-06",
      "unanswered_only": true
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "reviews": [
      {
        "review_id": "rv_5521",
        "client": "Maya B.",
        "rating": 5,
        "text": "Best balayage I have had.",
        "posted_at": "2026-10-12",
        "replied": false
      }
    ]
  },
  "isError": false
}

MCP tool vagaro_book_appointment

Books one client for one service with one provider at a start time from search_availability. Returns the appointment, its end time and price. The booking appears on the Vagaro calendar like one made by staff. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_book_appointment",
    "arguments": {
      "client_id": "cl_48213",
      "service_id": "svc_1172",
      "provider_id": "emp_309",
      "start": "2026-10-16T14:00:00-07:00",
      "notes": "Booked by agent from a Connect request"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "appointment_id": "apt_7730415",
    "status": "Booked",
    "client_id": "cl_48213",
    "service": "Balayage",
    "provider": "Alex",
    "start": "2026-10-16T14:00:00-07:00",
    "end": "2026-10-16T16:30:00-07:00",
    "price": {
      "amount": 185,
      "currency": "USD"
    }
  },
  "isError": false
}

MCP tool vagaro_reschedule_appointment

Moves one appointment to a new start time and optionally a new provider, the same change as dragging it on the calendar. Returns the old and new times. Pick the new start from search_availability. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_reschedule_appointment",
    "arguments": {
      "appointment_id": "apt_7730301",
      "start": "2026-10-14T09:00:00-07:00",
      "provider_id": "emp_311"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "appointment_id": "apt_7730415",
    "status": "Booked",
    "previous_start": "2026-10-14T11:30:00-07:00",
    "start": "2026-10-15T10:00:00-07:00",
    "end": "2026-10-15T12:30:00-07:00",
    "provider": "Alex"
  },
  "isError": false
}

MCP tool vagaro_cancel_appointment

Cancels one appointment, as Change Status then Cancel does on the Vagaro calendar. Set notify_client to tell the client. Refunds of prepayments and cancellation fees are not part of this tool; handle those in Vagaro. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_cancel_appointment",
    "arguments": {
      "appointment_id": "appointment_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "appointment_id": "apt_7730415",
    "status": "Cancelled",
    "client_notified": true
  },
  "isError": false
}

MCP tool vagaro_add_to_waitlist

Adds a client to the waitlist of a location for one service and day, as Vagaro lets staff do by hand. The date tells Vagaro when to notify the client. Returns the entry ID for list_waitlist. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_add_to_waitlist",
    "arguments": {
      "client_id": "client_8c41d2",
      "service_id": "service_8c41d2",
      "date": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "waitlist_entry_id": "wl_2052",
    "client": "Jamie Cole",
    "service": "Women's cut",
    "date": "2026-10-17",
    "provider": "any"
  },
  "isError": false
}

MCP tool vagaro_notify_waitlist

Offers an open slot to the waitlist entries you pick, like choosing a client by hand in the You Pick mode. Returns how many clients were alerted. Clients receive the alert, so it reaches people outside your account. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_notify_waitlist",
    "arguments": {
      "waitlist_entry_ids": [
        "waitlist entry ids"
      ],
      "start": "2026-10-01T09:00:00Z"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "alerted": 1,
    "waitlist_entry_ids": [
      "wl_2041"
    ],
    "start": "2026-10-14T14:00:00-07:00",
    "provider": "Alex"
  },
  "isError": false
}

MCP tool vagaro_reply_to_client

Sends a message in an existing Connect chat. Set include_booking_link to add your appointment booking link. Once a client has closed a chat, Vagaro needs a messaging plan on your side before you can keep replying. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_reply_to_client",
    "arguments": {
      "conversation_id": "conversation_8c41d2",
      "body": "body"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": "cv_2290",
    "message_id": "msg_8814",
    "status": "sent",
    "sent_at": "2026-10-13T16:10:00-07:00"
  },
  "isError": false
}

MCP tool vagaro_reply_to_review

Posts your reply under one review. The reply is public to other Vagaro users, the customer is notified, and the customer cannot comment again. There is no edit tool; edit or delete a reply in Vagaro on the web, tablet, Pay Desk or PayPro. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "vagaro_reply_to_review",
    "arguments": {
      "review_id": "review_8c41d2",
      "body": "body"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "review_id": "rv_5521",
    "status": "published",
    "replied_at": "2026-10-13T16:20:00-07:00"
  },
  "isError": false
}