# resOS MCP by usefulapi

> resOS MCP by usefulapi is an MCP server. Read bookings, guests and availability; create, update or cancel bookings in resOS. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/resos/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/resos
- **MCP Registry name:** io.usefulapi/resos
- **Listing updated:** 2026-11-13

## About

Read bookings, guests and availability; create, update or cancel bookings in resOS.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http resos https://resos.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://resos.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "resos": {
      "url": "https://resos.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "resos": {
      "type": "http",
      "url": "https://resos.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "resos": {
      "serverUrl": "https://resos.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "resos": {
      "type": "http",
      "url": "https://resos.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `resos_list_bookings`: List bookings, newest or oldest first as you sort, with date, time, party size, status, the guest's name, e-mail and phone, assigned tables and custom-field answers. Filter by date range, status, party size or guest name. The comment thread and sent-message log are not included (use resos_get_booking for the thread). Pages of at most 100; pass next_skip to read on. GET /bookings.
- `resos_get_booking`: One booking by id, with the guest's contact data, tables, custom fields, payment, the comment thread (guest and restaurant messages) and the internal restaurant notes. GET /bookings/{id}.
- `resos_list_customers`: List the restaurant's customers (guest profiles): name, e-mails, phones, city and country, tags, notes, flags, booking count and newsletter consent. The street address is not returned. Filter by name. Pages of at most 100. GET /customers.
- `resos_get_customer`: One customer (guest profile) by id: contact data, tags, notes, flags, booking count and latest booking. GET /customers/{id}.
- `resos_list_guest_feedback`: List guest feedback (ratings for food, service, value and atmosphere, whether they recommend, and the message). Filter by date range, or only submitted feedback. Pages of at most 100. GET /guestFeedback.
- `resos_get_guest_feedback`: One guest feedback entry by id. GET /guestFeedback/{id}.
- `resos_list_seating_areas`: List the seating areas with their tables (id, name, minimum and maximum seats) and table combinations. Use the ids for bookings and availability. GET /tables.
- `resos_list_opening_hours`: List the opening hours: regular weekly hours (day 1 Monday to 7 Sunday) and special date-specific hours, each with id, name, open and close times and whether the restaurant is open. GET /openingHours.
- `resos_get_opening_hour`: One opening-hour entry by id. GET /openingHours/{id}.
- `resos_list_custom_fields`: List the custom booking fields (name, label, type, required, choices). Use the ids to read or set custom-field answers. GET /customFields.
- `resos_get_custom_field`: One custom booking field by id. GET /customFields/{id}.
- `resos_get_available_dates`: Dates in a range on which the restaurant is open for bookings (default: the next 30 days). GET /bookingFlow/dates.
- `resos_get_available_times`: Booking times that are free on a date for a party size, optionally for one seating area. GET /bookingFlow/times.
- `resos_get_available_tables`: The tables and table combinations that are free for a party size in a time window (UTC). Use it before assigning tables to a booking. GET /bookingFlow/availableTables.
- `resos_create_booking`: WRITE: create a booking for a guest. It is a real booking in the restaurant's book. If notify_email or notify_sms is true, resOS e-mails or texts the GUEST (a confirmation); both default to false. Date and time are in the restaurant's local timezone. Check resos_get_available_times first: resOS may refuse a slot that is full or closed. It is not retried: if the call times out, read the bookings be
- `resos_update_booking`: WRITE: change fields of an existing booking: date, time, party size, tables, duration, status, or the guest's name, e-mail or phone. Only the fields you pass change. A status change or a new time can make resOS e-mail or text the GUEST (for example on approved or declined). To cancel use resos_cancel_booking. It is not retried: after a timeout read the booking again before you try again. PUT /book
- `resos_cancel_booking`: WRITE: cancel a booking (status canceled, with a canceled-at time). resOS may e-mail or text the GUEST a cancellation notice. The booking stays in resOS and can be read afterwards. Not retried: after a timeout read the booking first. PUT /bookings/{id}/cancel.
- `resos_add_booking_note`: WRITE: add an internal restaurant note to a booking (for example `Birthday, bring a candle`). The guest does not see it and nothing is sent. At most 50 notes per booking; notes cannot be deleted through the API. Not retried: after a timeout read the booking first, or the note may be added twice. POST /bookings/{id}/restaurantNote.
- `resos_send_booking_comment`: WRITE: post a comment from the restaurant on a booking's guest thread. The guest can see it. If send_notification is true, resOS e-mails or texts the GUEST the message now: you must choose true or false. At most 25 comments per booking and 5 per minute. Cannot be deleted through the API. Not retried: after a timeout read the booking first, or the guest may get it twice. POST /bookings/{id}/comment

## FAQ

### How do I add resOS MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http resos https://resos.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/resos-mcp-by-usefulapi
