OpenTable API and MCP server Let your AI agent get you the table.

ToolWhat it doesAccess

• search_restaurants Find restaurants with open tables for a place, date, time and party size. read

  Returns restaurants in the order OpenTable ranks them for the search, each with its restaurant_id, name, cuisine, neighborhood and the open times near the time you asked for. It searches the same listings as opentable.com. A restaurant with no table near that time can still show up with an empty list of times.

  MCP callopentable_read → search_restaurants

  REST endpointGET https://cotlet.dev/api/v1/opentable/restaurants/search

  Parameters

  Parameters: search_restaurants

  Name	Type	Description
  location string required	string	A city, neighborhood or address, for example "Union Square, San Francisco".
  date string required	string	Date in YYYY-MM-DD.
  time string required	string	Preferred time in HH:MM, 24-hour.
  party_size integer required	integer	Number of guests.
  query string	string	Cuisine or restaurant name, for example "italian" or "sushi".
  limit integer	integer	How many restaurants to return.

  Example input

  {
    "location": "location",
    "date": "date",
    "time": "time",
    "party_size": 1
  }

  Example response

  {
    "restaurants": [
      {
        "restaurant_id": "rid_104822",
        "name": "Trattoria Verde",
        "cuisine": "Italian",
        "neighborhood": "Union Square",
        "times": [
          "19:00",
          "19:30",
          "20:15"
        ]
      },
      {
        "restaurant_id": "rid_118305",
        "name": "Osteria Nove",
        "cuisine": "Italian",
        "neighborhood": "Union Square",
        "times": [
          "19:45"
        ]
      }
    ]
  }

• get_availability List the open times at one restaurant for a date and party size, with its booking policy. read

  Returns each open time with its seating area where the restaurant shows one, and the booking policy for that time: whether a credit card is required and the cancellation policy text the restaurant set. It reserves nothing; a time can be gone by the time you book. Use the slot_id with book_reservation or modify_reservation.

  MCP callopentable_read → get_availability

  REST endpointGET https://cotlet.dev/api/v1/opentable/restaurants/{restaurant_id}/availability

  Parameters

  Parameters: get_availability

  Name	Type	Description
  restaurant_id string required	string	A restaurant_id from search_restaurants or list_saved_restaurants.
  date string required	string	Date in YYYY-MM-DD.
  time string	string	Time in HH:MM to search around. Defaults to 19:00.
  party_size integer required	integer	Number of guests.

  Example input

  {
    "restaurant_id": "restaurant_8c41d2",
    "date": "date",
    "party_size": 1
  }

  Example response

  {
    "restaurant_id": "rid_104822",
    "date": "2026-10-30",
    "party_size": 6,
    "slots": [
      {
        "slot_id": "sl_7f21",
        "time": "19:00",
        "area": "Dining room"
      },
      {
        "slot_id": "sl_7f24",
        "time": "19:30",
        "area": "Patio"
      }
    ],
    "credit_card_required": true,
    "cancellation_policy": "Cancel at least 24 hours before your reservation to avoid a fee."
  }

• list_saved_restaurants List the restaurants saved on your OpenTable account. read

  Returns each saved restaurant with its restaurant_id, name, cuisine and neighborhood. The agent uses them to search where you already like to eat. It does not change the list.

  MCP callopentable_read → list_saved_restaurants

  REST endpointGET https://cotlet.dev/api/v1/opentable/saved-restaurants

  Parameters

  No parameters.

  Example response

  {
    "saved": [
      {
        "restaurant_id": "rid_120771",
        "name": "Harbor Room",
        "cuisine": "Seafood",
        "neighborhood": "Embarcadero"
      },
      {
        "restaurant_id": "rid_104822",
        "name": "Trattoria Verde",
        "cuisine": "Italian",
        "neighborhood": "Union Square"
      }
    ]
  }

• save_restaurant Add a restaurant to your saved restaurants, or remove it. write

  Returns the restaurant and whether it is saved now. It changes only your own list, reaches no one, and the same call with saved false undoes it, so it runs without asking you.

  MCP callopentable_write → save_restaurant

  REST endpointPOST https://cotlet.dev/api/v1/opentable/restaurants/{restaurant_id}/save

  Parameters

  Parameters: save_restaurant

  Name	Type	Description
  restaurant_id string required	string	A restaurant_id from search_restaurants.
  saved boolean	boolean	true to save, false to remove. Defaults to true.

  Example input

  {
    "restaurant_id": "restaurant_8c41d2"
  }

  Example response

  {
    "restaurant_id": "rid_120771",
    "name": "Harbor Room",
    "saved": true
  }

ToolWhat it doesAccess

• list_reservations List the upcoming or past reservations on your OpenTable account. read

  Returns each reservation with its reservation_id, restaurant, date and time, party size, status and the confirmation number, upcoming ones soonest first. It reads what your account shows under your reservations. Bookings you made by phone with the restaurant show up only if the restaurant linked them to your OpenTable profile.

  MCP callopentable_read → list_reservations

  REST endpointGET https://cotlet.dev/api/v1/opentable/reservations

  Parameters

  Parameters: list_reservations

  Name	Type	Description
  status string	string	upcoming or past. Defaults to upcoming.
  limit integer	integer	How many reservations to return.

  Example response

  {
    "reservations": [
      {
        "reservation_id": "res_55120",
        "restaurant": "Trattoria Verde",
        "date": "2026-10-31",
        "time": "19:00",
        "party_size": 4,
        "status": "confirmed",
        "confirmation": "2048"
      }
    ]
  }

• book_reservation Book a table at an open time on your OpenTable account. writeasks first

  Books the table in your name and the restaurant sees it in its reservation book, so the call waits for your approval. Where the restaurant requires a credit card, the call stops and returns a link to finish in OpenTable, because Cotlet never enters card details. Returns the reservation_id and the confirmation number. By default you confirm each call; you can switch that off for this tool.

  MCP callopentable_write → book_reservation

  REST endpointPOST https://cotlet.dev/api/v1/opentable/restaurants/{restaurant_id}/reservations

  Parameters

  Parameters: book_reservation

  Name	Type	Description
  restaurant_id string required	string	A restaurant_id from search_restaurants.
  slot_id string required	string	A slot_id from get_availability.
  party_size integer required	integer	Number of guests, the same as in get_availability.
  special_request string	string	A note for the restaurant, for example "high chair" or "birthday".

  Example input

  {
    "restaurant_id": "rid_104822",
    "slot_id": "sl_7f21",
    "party_size": 6,
    "special_request": "Birthday dinner"
  }

  Example response

  {
    "reservation_id": "res_55120",
    "restaurant": "Trattoria Verde",
    "date": "2026-10-30",
    "time": "19:00",
    "party_size": 6,
    "status": "confirmed",
    "confirmation": "2048"
  }

• modify_reservation Change the time, date, party size or special request of one of your reservations. writeasks first

  Changes the booking the restaurant sees, so the call waits for your approval. A new time must come from get_availability for the new party size. When the change is not possible, the reservation stays as it was and the call returns why. By default you confirm each call; you can switch that off for this tool.

  MCP callopentable_write → modify_reservation

  REST endpointPOST https://cotlet.dev/api/v1/opentable/reservations/{reservation_id}/modify

  Parameters

  Parameters: modify_reservation

  Name	Type	Description
  reservation_id string required	string	A reservation_id from list_reservations.
  slot_id string	string	A new slot_id from get_availability. Leave out to keep the time.
  party_size integer	integer	New number of guests.
  special_request string	string	New note for the restaurant.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "res_55120",
    "restaurant": "Trattoria Verde",
    "date": "2026-10-31",
    "time": "20:30",
    "party_size": 4,
    "status": "confirmed"
  }

• cancel_reservation Cancel one of your reservations. writeasks first

  Cancels the booking and frees the table for the restaurant, so the call waits for your approval. OpenTable asks diners to cancel at least 30 minutes ahead, and a restaurant can charge a fee under its own cancellation policy, which get_availability returns. A cancelled reservation cannot be restored; book again instead. By default you confirm each call; you can switch that off for this tool.

  MCP callopentable_write → cancel_reservation

  REST endpointPOST https://cotlet.dev/api/v1/opentable/reservations/{reservation_id}/cancel

  Parameters

  Parameters: cancel_reservation

  Name	Type	Description
  reservation_id string required	string	A reservation_id from list_reservations.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "res_55120",
    "restaurant": "Trattoria Verde",
    "status": "cancelled"
  }

ToolWhat it doesAccess

• list_restaurant_reservations Read your restaurant's reservation book for a date, with party size, status, tags and notes. read

  Returns the reservations OpenTable for Restaurants shows for that date in time order, each with guest name, guest_id, time, party size, status, guest and visit tags, and the visit note. It needs an OpenTable for Restaurants login with access to the reservation book. It changes nothing.

  MCP callopentable_read → list_restaurant_reservations

  REST endpointGET https://cotlet.dev/api/v1/opentable/restaurant-reservations

  Parameters

  Parameters: list_restaurant_reservations

  Name	Type	Description
  date string required	string	Date in YYYY-MM-DD.
  shift string	string	A shift name as your restaurant sets it, for example "Dinner". Defaults to all shifts.

  Example input

  {
    "date": "date"
  }

  Example response

  {
    "date": "2026-10-27",
    "reservations": [
      {
        "reservation_id": "rr_88410",
        "time": "18:30",
        "guest": "Alex Rivera",
        "guest_id": "g_30115",
        "party_size": 2,
        "status": "confirmed",
        "tags": [
          "Anniversary"
        ],
        "note": "Celebrating 10 years"
      },
      {
        "reservation_id": "rr_88422",
        "time": "19:15",
        "guest": "Sam Lee",
        "guest_id": "g_30422",
        "party_size": 4,
        "status": "confirmed",
        "tags": [
          "Shellfish allergy"
        ],
        "note": ""
      }
    ]
  }

• get_guest Read one guest profile from your Guestbook: tags, notes and visit history. read

  Returns the guest's name, guest tags, notes and the number of past visits with the last visit date, as OpenTable for Restaurants shows them. Guest tags stay on the profile for future visits; visit tags belong to one reservation. Contact details are left out of the response.

  MCP callopentable_read → get_guest

  REST endpointGET https://cotlet.dev/api/v1/opentable/guests/{guest_id}

  Parameters

  Parameters: get_guest

  Name	Type	Description
  guest_id string required	string	A guest_id from list_restaurant_reservations.

  Example input

  {
    "guest_id": "guest_8c41d2"
  }

  Example response

  {
    "guest_id": "g_30115",
    "name": "Alex Rivera",
    "tags": [
      "Regular",
      "Wine lover"
    ],
    "notes": [
      "Prefers a booth"
    ],
    "visits": 9,
    "last_visit": "2026-09-12"
  }

• add_guest_note Add a note or guest tags to a guest profile in your restaurant's Guestbook. write

  Returns the guest profile with its tags and notes after the change. Notes and tags are internal to your restaurant team; the guest is not told, and you remove them in the Guestbook in one step, so it runs without asking you. It only uses tags that exist in your restaurant's tag list.

  MCP callopentable_write → add_guest_note

  REST endpointPOST https://cotlet.dev/api/v1/opentable/guests/{guest_id}/note

  Parameters

  Parameters: add_guest_note

  Name	Type	Description
  guest_id string required	string	A guest_id from list_restaurant_reservations.
  note string	string	Note text, for example "Prefers a quiet table".
  tags array	array	Names of guest tags your restaurant already has, for example ["Shellfish allergy"].

  Example input

  {
    "guest_id": "guest_8c41d2"
  }

  Example response

  {
    "guest_id": "g_30422",
    "name": "Sam Lee",
    "tags": [
      "Shellfish allergy",
      "Regular"
    ],
    "notes": [
      "Allergy confirmed by phone"
    ]
  }

• list_waitlist Read the parties on your restaurant's waitlist right now. read

  Returns each waiting party with its waitlist_id, guest name, party size, the time they joined and the quoted wait, in the order OpenTable for Restaurants shows them. It needs a restaurant login with access to the waitlist. It changes nothing.

  MCP callopentable_read → list_waitlist

  REST endpointGET https://cotlet.dev/api/v1/opentable/waitlists

  Parameters

  No parameters.

  Example response

  {
    "waitlist": [
      {
        "waitlist_id": "wl_3011",
        "guest": "Jordan Park",
        "party_size": 2,
        "joined_at": "19:05",
        "quoted_minutes": 25
      },
      {
        "waitlist_id": "wl_3012",
        "guest": "Taylor Green",
        "party_size": 5,
        "joined_at": "19:10",
        "quoted_minutes": 40
      }
    ]
  }

• notify_waitlist_party Text a party on the waitlist that their table is ready. writeasks first

  Sends the guest the table-ready text message OpenTable for Restaurants sends from the waitlist, so the call waits for your approval. A text cannot be taken back. Returns the party and the time the text went out. By default you confirm each call; you can switch that off for this tool.

  MCP callopentable_write → notify_waitlist_party

  REST endpointPOST https://cotlet.dev/api/v1/opentable/waitlists/{waitlist_id}/party/notify

  Parameters

  Parameters: notify_waitlist_party

  Name	Type	Description
  waitlist_id string required	string	A waitlist_id from list_waitlist.

  Example input

  {
    "waitlist_id": "waitlist_8c41d2"
  }

  Example response

  {
    "waitlist_id": "wl_3011",
    "guest": "Jordan Park",
    "party_size": 2,
    "notified_at": "19:31"
  }