ChowNow API and MCP server Let your AI agent run the ChowNow Dashboard.

ToolWhat it doesAccess

• list_locations List the restaurant locations your ChowNow account can open. read

  Returns the locations under Headquarters that your account can open, with the ID each other tool needs. A one-location restaurant gets one entry.

  MCP callchownow_read → list_locations

  REST endpointGET https://cotlet.dev/api/v1/chownow/locations

  Parameters

  No parameters.

  Example response

  {
    "locations": [
      {
        "location_id": "loc_8f2a41",
        "name": "Main Street",
        "ordering_paused": false
      },
      {
        "location_id": "loc_c91d07",
        "name": "Harbor Road",
        "ordering_paused": true
      }
    ]
  }

• list_orders List orders of a location, newest first. read

  Returns each order with its number, status, type and total, in the order the Dashboard lists them. Follow next_cursor for older orders. Order details are in get_order.

  MCP callchownow_read → list_orders

  REST endpointGET https://cotlet.dev/api/v1/chownow/locations/{location_id}/orders

  Parameters

  Parameters: list_orders

  Name	Type	Description
  location_id string required	string	Location ID from list_locations.
  source string	string	chownow for ChowNow Orders, third_party for Third Party Orders. Default chownow.
  status string	string	Status as the Dashboard shows it in All Statuses, for example New.
  search string	string	Text to find a specific order, as in the Dashboard search box.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "location_id": "location_8c41d2"
  }

  Example response

  {
    "orders": [
      {
        "order_id": "ord_30417",
        "number": "30417",
        "status": "New",
        "type": "pickup",
        "total": "42.50"
      },
      {
        "order_id": "ord_30416",
        "number": "30416",
        "status": "Accepted",
        "type": "delivery",
        "total": "67.80"
      }
    ],
    "next_cursor": null
  }

• get_order Get the full detail of one order. read

  Returns the itemized order with modifiers, the customer name and contact information, tips, taxes, discounts and special instructions, as the order page in the Dashboard shows them.

  MCP callchownow_read → get_order

  REST endpointGET https://cotlet.dev/api/v1/chownow/orders/{order_id}

  Parameters

  Parameters: get_order

  Name	Type	Description
  order_id string required	string	Order ID from list_orders.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_id": "ord_30417",
    "number": "30417",
    "status": "New",
    "type": "pickup",
    "customer": "Dana R.",
    "items": [
      {
        "name": "Salmon Bowl",
        "quantity": 2,
        "modifiers": [
          "No sesame"
        ]
      },
      {
        "name": "Mango Lassi",
        "quantity": 1,
        "modifiers": []
      }
    ],
    "tip": "5.00",
    "total": "42.50",
    "instructions": "Please include chopsticks"
  }

• accept_order Accept a new order and set its pickup or delivery time. writeasks first

  Opens the order, clicks Accept or Cancel, then Accept Order with your time and returns the new status. The diner gets a confirmation with the approximate pickup or delivery time, so the call reaches a customer. Only orders with the status New can be accepted; any other status fails. By default you confirm each call; you can switch that off for this tool.

  MCP callchownow_write → accept_order

  REST endpointPOST https://cotlet.dev/api/v1/chownow/orders/{order_id}/accept

  Parameters

  Parameters: accept_order

  Name	Type	Description
  order_id string required	string	Order ID from list_orders.
  ready_in_minutes integer required	integer	Minutes from now until the order is ready, the custom time of the Accept Order dialog.

  Example input

  {
    "order_id": "order_8c41d2",
    "ready_in_minutes": 1
  }

  Example response

  {
    "order_id": "ord_30417",
    "status": "Accepted",
    "ready_in_minutes": 25
  }

ToolWhat it doesAccess

• list_menu_items List the items and modifiers of a location with their availability. read

  Returns what the Dashboard shows under Item Availability: each item or modifier with its toggle state. Use the IDs in set_item_availability.

  MCP callchownow_read → list_menu_items

  REST endpointGET https://cotlet.dev/api/v1/chownow/locations/{location_id}/menu-items

  Parameters

  Parameters: list_menu_items

  Name	Type	Description
  location_id string required	string	Location ID from list_locations.
  kind string	string	items or modifiers. Default items.
  available boolean	boolean	Only items that are on (true) or hidden (false). Both when left out.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "location_id": "location_8c41d2"
  }

  Example response

  {
    "items": [
      {
        "item_id": "itm_1042",
        "name": "Salmon Bowl",
        "available": true
      },
      {
        "item_id": "itm_1057",
        "name": "Mango Lassi",
        "available": true
      }
    ],
    "next_cursor": null
  }

• set_item_availability Hide or show a menu item or modifier for diners. write

  Flips the toggle under Item Availability. A hidden item disappears from the customer menu on every connected platform until you show it again. It reaches no one directly and one more call undoes it, so it does not wait for your OK by default.

  MCP callchownow_write → set_item_availability

  REST endpointPUT https://cotlet.dev/api/v1/chownow/locations/{location_id}/items/{item_id}/availability

  Parameters

  Parameters: set_item_availability

  Name	Type	Description
  location_id string required	string	Location ID from list_locations.
  item_id string required	string	Item or modifier ID from list_menu_items.
  available boolean required	boolean	false hides the item, true shows it again.

  Example input

  {
    "location_id": "loc_8f2a41",
    "item_id": "itm_1042",
    "available": false
  }

  Example response

  {
    "item_id": "itm_1042",
    "name": "Salmon Bowl",
    "available": false
  }

ToolWhat it doesAccess

• get_hours Read pickup and delivery hours of a location. read

  Returns the hours by day for pickup and for delivery, as the Edit Hours page shows them. Menu hours set in the Menu Editor schedule also apply to every platform connected to that menu.

  MCP callchownow_read → get_hours

  REST endpointGET https://cotlet.dev/api/v1/chownow/locations/{location_id}/hours

  Parameters

  Parameters: get_hours

  Name	Type	Description
  location_id string required	string	Location ID from list_locations.

  Example input

  {
    "location_id": "location_8c41d2"
  }

  Example response

  {
    "pickup": [
      {
        "day": "friday",
        "open": "11:00",
        "close": "22:00"
      }
    ],
    "delivery": [
      {
        "day": "friday",
        "open": "11:30",
        "close": "21:30"
      }
    ]
  }

• update_hours Change the pickup or delivery hours of one day. writeasks first

  Writes the new hours on the Edit Hours page and returns them. Menu hours cannot overlap: ChowNow answers with an error when they do, and nothing changes. The new hours decide when diners can order. By default you confirm each call; you can switch that off for this tool.

  MCP callchownow_write → update_hours

  REST endpointPATCH https://cotlet.dev/api/v1/chownow/locations/{location_id}/hours

  Parameters

  Parameters: update_hours

  Name	Type	Description
  location_id string required	string	Location ID from list_locations.
  order_type string required	string	pickup or delivery.
  day string required	string	Day of the week in lowercase, for example friday.
  open string required	string	Opening time, HH:MM.
  close string required	string	Closing time, HH:MM.

  Example input

  {
    "location_id": "location_8c41d2",
    "order_type": "order type",
    "day": "day",
    "open": "open",
    "close": "close"
  }

  Example response

  {
    "order_type": "delivery",
    "day": "friday",
    "open": "11:30",
    "close": "23:00"
  }

• list_closures List current and future temporary closures of a location. read

  Returns the closures from Settings > Closures. An active closure is a common reason a location stops getting orders, so check this first when orders stop.

  MCP callchownow_read → list_closures

  REST endpointGET https://cotlet.dev/api/v1/chownow/locations/{location_id}/closures

  Parameters

  Parameters: list_closures

  Name	Type	Description
  location_id string required	string	Location ID from list_locations.

  Example input

  {
    "location_id": "location_8c41d2"
  }

  Example response

  {
    "closures": [
      {
        "closure_id": "clo_552",
        "starts_at": "2026-11-26T00:00:00",
        "ends_at": "2026-11-27T00:00:00",
        "reason": "Thanksgiving"
      }
    ]
  }

• create_closure Close a location for a set period, now or in the future. writeasks first

  Adds a closure under Settings > Closures. Ordering is suspended for that period, so diners cannot order at the location until it ends or you remove it with remove_closure. By default you confirm each call; you can switch that off for this tool.

  MCP callchownow_write → create_closure

  REST endpointPOST https://cotlet.dev/api/v1/chownow/locations/{location_id}/closures

  Parameters

  Parameters: create_closure

  Name	Type	Description
  location_id string required	string	Location ID from list_locations.
  starts_at string required	string	Start, ISO date and time in the location time zone.
  ends_at string required	string	End, ISO date and time in the location time zone.
  reason string	string	A note for yourself, for example Thanksgiving.

  Example input

  {
    "location_id": "location_8c41d2",
    "starts_at": "starts at",
    "ends_at": "ends at"
  }

  Example response

  {
    "closure_id": "clo_552",
    "starts_at": "2026-11-26T00:00:00",
    "ends_at": "2026-11-27T00:00:00",
    "reason": "Thanksgiving"
  }

• remove_closure Remove a temporary closure so the location takes orders again. writeasks first

  Deletes the closure under Settings > Closures. Diners can order again when the location hours allow it. By default you confirm each call; you can switch that off for this tool.

  MCP callchownow_write → remove_closure

  REST endpointDELETE https://cotlet.dev/api/v1/chownow/locations/{location_id}/closures/{closure_id}

  Parameters

  Parameters: remove_closure

  Name	Type	Description
  location_id string required	string	Location ID from list_locations.
  closure_id string required	string	Closure ID from list_closures.

  Example input

  {
    "location_id": "location_8c41d2",
    "closure_id": "closure_8c41d2"
  }

  Example response

  {
    "closure_id": "clo_552",
    "removed": true
  }

ToolWhat it doesAccess

• list_customers List customers of a location with their order counts. read

  Returns what the Customer Data report holds: email address, date of the last order and number of orders. Customers who opted out are left out, as in the Dashboard.

  MCP callchownow_read → list_customers

  REST endpointGET https://cotlet.dev/api/v1/chownow/locations/{location_id}/customers

  Parameters

  Parameters: list_customers

  Name	Type	Description
  location_id string required	string	Location ID from list_locations.
  min_orders integer	integer	Only customers with at least this many orders.
  last_order_before string	string	ISO date. Only customers whose last order is before it.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "location_id": "location_8c41d2"
  }

  Example response

  {
    "customers": [
      {
        "name": "Dana R.",
        "email": "dana@example.com",
        "last_order": "2026-09-14",
        "orders": 6
      },
      {
        "name": "Marcus T.",
        "email": "marcus@example.com",
        "last_order": "2026-08-30",
        "orders": 3
      }
    ],
    "next_cursor": null
  }