Meevo MCP tools

MCP tool meevo_list_locations

Returns every Meevo location your staff login can reach. Use location_id from each item as the location_id parameter of the other tools. Time zone is the one set on the location.

Parameters

No parameters.

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "locations": [
      {
        "location_id": "201",
        "name": "Maple Street Salon",
        "address": "12 Maple St, Hoboken, NJ",
        "time_zone": "America/New_York"
      },
      {
        "location_id": "202",
        "name": "Harbor Spa",
        "address": "88 Harbor Rd, Jersey City, NJ",
        "time_zone": "America/New_York"
      }
    ]
  },
  "isError": false
}

MCP tool meevo_list_services

Lists the service menu of one location grouped by category. Each service has its duration, price and add-ons. Use service_id with find_open_slots and book_appointment.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "categories": [
      {
        "category": "Color",
        "services": [
          {
            "service_id": "9a8b7c6d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
            "name": "Balayage",
            "duration_minutes": 150,
            "price": 220,
            "add_ons": [
              "Toner"
            ]
          }
        ]
      }
    ]
  },
  "isError": false
}

MCP tool meevo_list_staff

Lists the employees of one location with their title and the services each performs. Use staff_id to narrow list_appointments and find_open_slots, or to book with a specific employee.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "staff": [
      {
        "staff_id": "e1d2c3b4-a5f6-4e7d-9c8b-7a6f5e4d3c2b",
        "name": "Alex Rivera",
        "title": "Senior Stylist",
        "services": [
          "Balayage",
          "Haircut"
        ]
      },
      {
        "staff_id": "a7b8c9d0-e1f2-4a3b-8c4d-9e0f1a2b3c4d",
        "name": "Sam Patel",
        "title": "Stylist",
        "services": [
          "Balayage",
          "Blowout"
        ]
      }
    ]
  },
  "isError": false
}

MCP tool meevo_list_appointments

Returns appointments from the Appointment Book for one location, oldest start first. Canceled appointments are left out unless include_canceled is true. Confirmation status is the one Meevo shows on the appointment. Use appointment_id with reschedule_appointment and cancel_appointment.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "appointments": [
      {
        "appointment_id": "4b5c6d7e-8f90-4a1b-b2c3-d4e5f6a7b8c9",
        "start": "2026-10-12T09:00:00-04:00",
        "end": "2026-10-12T11:30:00-04:00",
        "client": {
          "id": "c3f1a2b4-5d6e-4f70-8a91-0b2c3d4e5f60",
          "name": "Jamie Doe"
        },
        "services": [
          "Balayage"
        ],
        "staff": "Alex Rivera",
        "confirmation_status": "confirmed"
      },
      {
        "appointment_id": "7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
        "start": "2026-10-12T14:00:00-04:00",
        "end": "2026-10-12T14:45:00-04:00",
        "client": {
          "id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a",
          "name": "Sam Lee"
        },
        "services": [
          "Haircut"
        ],
        "staff": "Alex Rivera",
        "confirmation_status": "unconfirmed"
      }
    ]
  },
  "isError": false
}

MCP tool meevo_find_open_slots

Returns open start times for one service in a date range, earliest first, each with the employees free at that time. Without staff_id it searches every employee who performs the service. Use a start and staff_id from the result with book_appointment.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meevo_find_open_slots",
    "arguments": {
      "location_id": "201",
      "service_id": "9a8b7c6d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
      "from": "2026-10-18",
      "to": "2026-10-19"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "slots": [
      {
        "start": "2026-10-17T10:00:00-04:00",
        "staff": [
          {
            "staff_id": "e1d2c3b4-a5f6-4e7d-9c8b-7a6f5e4d3c2b",
            "name": "Alex Rivera"
          }
        ]
      },
      {
        "start": "2026-10-17T11:30:00-04:00",
        "staff": [
          {
            "staff_id": "a7b8c9d0-e1f2-4a3b-8c4d-9e0f1a2b3c4d",
            "name": "Sam Patel"
          }
        ]
      }
    ]
  },
  "isError": false
}

MCP tool meevo_find_client

Searches client profiles by name, email or phone and returns the matches with contact details and client type. Use client_id with get_client, book_appointment and sell_package. If several clients match, your agent should ask which one before it books.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "clients": [
      {
        "client_id": "c3f1a2b4-5d6e-4f70-8a91-0b2c3d4e5f60",
        "name": "Jamie Doe",
        "email": "client@example.com",
        "phone": "+15555550123",
        "client_type": "Regular"
      }
    ]
  },
  "isError": false
}

MCP tool meevo_get_client

Returns one client profile with upcoming appointments, visit notes, memberships, packages, gift cards and points. Use it before booking or selling, so your agent sees what the client already owns.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "client_id": "c3f1a2b4-5d6e-4f70-8a91-0b2c3d4e5f60",
    "name": "Jamie Doe",
    "upcoming_appointments": [
      {
        "appointment_id": "4b5c6d7e-8f90-4a1b-b2c3-d4e5f6a7b8c9",
        "start": "2026-10-12T09:00:00-04:00",
        "services": [
          "Balayage"
        ]
      }
    ],
    "visit_notes": [
      {
        "note_type": "Color formula",
        "text": "Formula 7N plus 20 vol.",
        "created_at": "2026-09-14T16:20:00-04:00"
      }
    ],
    "packages": [
      {
        "name": "5 Blowouts",
        "visits_left": 2
      }
    ],
    "memberships": [],
    "gift_cards": [],
    "points": 120
  },
  "isError": false
}

MCP tool meevo_list_packages

Lists the packages and memberships you sell at one location, with price and included services. kind narrows the list. Use package_id with sell_package.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "packages": [
      {
        "package_id": "5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c",
        "kind": "package",
        "name": "5 Blowouts",
        "price": 200,
        "includes": [
          "Blowout x5"
        ]
      }
    ]
  },
  "isError": false
}

MCP tool meevo_get_register_summary

Returns the Register Summary of one location for one business day: sales by type, payments by method, membership sales, returns and deposits. Sales by type add up to total_sales, and payments add up to the same total. Reads one location per call.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meevo_get_register_summary",
    "arguments": {
      "location_id": "201",
      "date": "2026-10-10"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "location_id": "201",
    "date": "2026-10-10",
    "currency": "USD",
    "sales_by_type": {
      "services": 2840,
      "products": 410,
      "packages": 600
    },
    "total_sales": 3850,
    "payments": {
      "card": 3120.5,
      "cash": 500,
      "gift_card": 229.5
    },
    "membership_sales": 0,
    "returns": 0,
    "deposits": 150
  },
  "isError": false
}

MCP tool meevo_add_visit_note

Adds an internal visit note to a client profile, for example a color formula. The note is visible to staff, not to the client. note_type must be one set up at your location. 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": "meevo_add_visit_note",
    "arguments": {
      "client_id": "client_8c41d2",
      "text": "text"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "note_id": "n_20311",
    "client_id": "c3f1a2b4-5d6e-4f70-8a91-0b2c3d4e5f60",
    "note_type": "Color formula",
    "status": "saved"
  },
  "isError": false
}

MCP tool meevo_book_appointment

Books one or more services in order for a client with one employee, starting at the time you give. Meevo sends your usual confirmation to the client. The call fails if the time is no longer free. 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": "meevo_book_appointment",
    "arguments": {
      "client_id": "c3f1a2b4-5d6e-4f70-8a91-0b2c3d4e5f60",
      "location_id": "201",
      "service_ids": [
        "9a8b7c6d-1e2f-4a3b-8c4d-5e6f7a8b9c0d"
      ],
      "staff_id": "e1d2c3b4-a5f6-4e7d-9c8b-7a6f5e4d3c2b",
      "start": "2026-10-17T10:00:00-04:00"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "appointment_id": "4b5c6d7e-8f90-4a1b-b2c3-d4e5f6a7b8c9",
    "status": "booked",
    "client": {
      "id": "c3f1a2b4-5d6e-4f70-8a91-0b2c3d4e5f60",
      "name": "Jamie Doe",
      "email": "client@example.com"
    },
    "services": [
      {
        "id": "9a8b7c6d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
        "name": "Balayage",
        "duration_minutes": 150,
        "staff": "Alex Rivera"
      }
    ],
    "start": "2026-10-17T10:00:00-04:00",
    "end": "2026-10-17T12:30:00-04:00",
    "confirmation_status": "unconfirmed"
  },
  "isError": false
}

MCP tool meevo_reschedule_appointment

Moves one appointment to a new start time, a new employee, or both. The services stay the same. Meevo sends your usual confirmation for the changed appointment. 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": "meevo_reschedule_appointment",
    "arguments": {
      "appointment_id": "4b5c6d7e-8f90-4a1b-b2c3-d4e5f6a7b8c9",
      "start": "2026-10-16T09:00:00-04:00",
      "staff_id": "a7b8c9d0-e1f2-4a3b-8c4d-9e0f1a2b3c4d"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "appointment_id": "4b5c6d7e-8f90-4a1b-b2c3-d4e5f6a7b8c9",
    "status": "rescheduled",
    "start": "2026-10-17T10:00:00-04:00",
    "end": "2026-10-17T12:30:00-04:00",
    "staff": "Sam Patel"
  },
  "isError": false
}

MCP tool meevo_cancel_appointment

Cancels one appointment and records the reason you give. reason must be one set up at your location. Canceling affects the client's booking, so confirm it. 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": "meevo_cancel_appointment",
    "arguments": {
      "appointment_id": "appointment_8c41d2",
      "reason": "reason"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "appointment_id": "7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
    "status": "canceled",
    "reason": "Client request"
  },
  "isError": false
}

MCP tool meevo_sell_package

Rings up one package for a client in the Register and records the payment. payment_type must match a payment type named in your Register. It moves money, so confirm it. 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": "meevo_sell_package",
    "arguments": {
      "client_id": "client_8c41d2",
      "package_id": "package_8c41d2",
      "payment_type": "payment type"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "sale_id": "s_88421",
    "status": "paid",
    "client_id": "c3f1a2b4-5d6e-4f70-8a91-0b2c3d4e5f60",
    "package": "5 Blowouts",
    "amount": 200,
    "payment_type": "Cash"
  },
  "isError": false
}