Mews MCP server Let your AI agent run your Mews front desk.

ToolWhat it doesAccess

• list_arrivals Reservations arriving on a day, as in Reservation overview, Arrivals tab. read

  Returns the reservations arriving on the day with guest name, status and the guest count that the tab shows. Statuses are the tab's own groups: To check in, Checked in online and Checked in. The account needs access to Reservation overview in Mews.

  MCP callmews_read → list_arrivals

  REST endpointGET https://cotlet.dev/api/v1/mews/arrivals

  Parameters

  Parameters: list_arrivals

  Name	Type	Description
  date string	string	Day to read, YYYY-MM-DD. Defaults to today in the property time zone.

  Example response

  {
    "date": "2026-11-06",
    "reservations": 3,
    "guests": 5,
    "arrivals": [
      {
        "reservation_id": "a1f0c2d4-7b6e-4c1a-9e31-2f5d8b0c1a01",
        "guest": "Lindgren, Eva",
        "status": "To check in",
        "nights": 3
      },
      {
        "reservation_id": "a1f0c2d4-7b6e-4c1a-9e31-2f5d8b0c1a02",
        "guest": "Okafor, Tunde",
        "status": "Checked in online",
        "nights": 2
      },
      {
        "reservation_id": "a1f0c2d4-7b6e-4c1a-9e31-2f5d8b0c1a03",
        "guest": "Moreau, Claire",
        "status": "Checked in",
        "nights": 1
      }
    ]
  }

• list_departures Reservations departing on a day, as in Reservation overview, Departures tab. read

  Returns the reservations departing on the day. Bookings not yet checked out come first, and those flagged Check-out missed are marked. Completed departures follow, labeled Past. The account needs access to Reservation overview in Mews.

  MCP callmews_read → list_departures

  REST endpointGET https://cotlet.dev/api/v1/mews/departures

  Parameters

  Parameters: list_departures

  Name	Type	Description
  date string	string	Day to read, YYYY-MM-DD. Defaults to today in the property time zone.

  Example response

  {
    "date": "2026-11-06",
    "reservations": 3,
    "guests": 4,
    "departures": [
      {
        "reservation_id": "b2e1d3c5-8c7f-4d2b-8f42-3a6e9c1d2b01",
        "guest": "Haddad, Samir",
        "status": "Check-out missed"
      },
      {
        "reservation_id": "b2e1d3c5-8c7f-4d2b-8f42-3a6e9c1d2b02",
        "guest": "Novak, Petra",
        "status": "Not checked out"
      },
      {
        "reservation_id": "b2e1d3c5-8c7f-4d2b-8f42-3a6e9c1d2b03",
        "guest": "Silva, Marco",
        "status": "Past"
      }
    ]
  }

• list_guests_in_house Guests staying at the property, as in the Guests in house report. read

  Returns each booking in the interval with guest name, status, arrival and departure dates and reservation notes. Mews shows guests arriving on the selected day and guests staying at least one night in the interval. Use it for a room-by-room list.

  MCP callmews_read → list_guests_in_house

  REST endpointGET https://cotlet.dev/api/v1/mews/guests-in-houses

  Parameters

  Parameters: list_guests_in_house

  Name	Type	Description
  start_date string	string	First day of the interval, YYYY-MM-DD. Defaults to today.
  end_date string	string	Last day of the interval, YYYY-MM-DD. Defaults to the start date.
  status string	string	Reservation status filter: Checked out, Checked-in, Confirmed or Optional. Defaults to guests currently at the property.
  order_by string	string	Ordering: last_name or room_number.

  Example response

  {
    "start_date": "2026-11-06",
    "end_date": "2026-11-06",
    "order_by": "room_number",
    "guests": [
      {
        "reservation_id": "c3d2e4f6-9d8a-4e3c-9a53-4b7f0d2e3c01",
        "room": "204",
        "guest": "Lindgren, Eva",
        "status": "Checked-in",
        "arrival": "2026-11-06",
        "departure": "2026-11-09",
        "notes": "Late arrival"
      },
      {
        "reservation_id": "c3d2e4f6-9d8a-4e3c-9a53-4b7f0d2e3c02",
        "room": "310",
        "guest": "Okafor, Tunde",
        "status": "Checked-in",
        "arrival": "2026-11-05",
        "departure": "2026-11-08",
        "notes": ""
      }
    ]
  }

• get_stay_statistics Daily counts from Reservation overview, Statistics tab. read

  Returns one row per day with the columns the Statistics tab shows: Arrivals (Online), Departures (Online), Stayovers and Staying. Mews exports these totals to Excel; for full reservation details use list_reservations.

  MCP callmews_read → get_stay_statistics

  REST endpointGET https://cotlet.dev/api/v1/mews/stay-statistics

  Parameters

  Parameters: get_stay_statistics

  Name	Type	Description
  start_date string required	string	First day, YYYY-MM-DD.
  end_date string required	string	Last day, YYYY-MM-DD.

  Example input

  {
    "start_date": "start date",
    "end_date": "end date"
  }

  Example response

  {
    "days": [
      {
        "date": "2026-11-06",
        "arrivals_online": 1,
        "departures_online": 0,
        "stayovers": 18,
        "staying": 22
      },
      {
        "date": "2026-11-07",
        "arrivals_online": 2,
        "departures_online": 1,
        "stayovers": 20,
        "staying": 25
      }
    ]
  }

ToolWhat it doesAccess

• list_reservations Reservations by status and date, as in the Reservation report. read

  Returns the reservations that match, each with status, customer, arrival and departure. The Reservation report in Mews is the source, in its detailed mode. Use the reservation_id with get_reservation or cancel_reservation.

  MCP callmews_read → list_reservations

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

  Parameters

  Parameters: list_reservations

  Name	Type	Description
  status string	string	Status filter: Canceled, Checked out, Checked in, Confirmed, Inquired or Optional.
  start_date string	string	First day of the interval, YYYY-MM-DD.
  end_date string	string	Last day of the interval, YYYY-MM-DD.
  guest string	string	Guest name to search for, as in the Mews search bar.

  Example response

  {
    "reservations": [
      {
        "reservation_id": "d4e3f5a7-0e9b-4f4d-8b64-5c8a1e3f4d01",
        "status": "Optional",
        "customer": "Haddad, Samir",
        "customer_id": "e5f4a6b8-1f0c-4a5e-9c75-6d9b2f4a5e01",
        "arrival": "2026-11-10",
        "departure": "2026-11-12"
      },
      {
        "reservation_id": "d4e3f5a7-0e9b-4f4d-8b64-5c8a1e3f4d02",
        "status": "Optional",
        "customer": "Novak, Petra",
        "customer_id": "e5f4a6b8-1f0c-4a5e-9c75-6d9b2f4a5e02",
        "arrival": "2026-11-11",
        "departure": "2026-11-13"
      }
    ]
  }

• get_reservation One reservation with its status, dates, notes and customer. read

  Returns what the reservation screen shows: status, arrival and departure, the notes saved in the Notes section and the linked customer. Read it before cancel_reservation to check that the guest has not checked in.

  MCP callmews_read → get_reservation

  REST endpointGET https://cotlet.dev/api/v1/mews/reservations/{reservation_id}

  Parameters

  Parameters: get_reservation

  Name	Type	Description
  reservation_id string required	string	Reservation ID from list_reservations, list_arrivals or list_departures.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "d4e3f5a7-0e9b-4f4d-8b64-5c8a1e3f4d01",
    "status": "Optional",
    "arrival": "2026-11-10",
    "departure": "2026-11-12",
    "customer": {
      "customer_id": "e5f4a6b8-1f0c-4a5e-9c75-6d9b2f4a5e01",
      "name": "Haddad, Samir"
    },
    "notes": [
      "Waiting for company confirmation"
    ]
  }

• find_customer Customers whose name matches the search, as in the Mews search bar. read

  Returns matching customer profiles with their IDs and current and future reservations. It searches the property of the signed-in account. Use customer_id with get_customer.

  MCP callmews_read → find_customer

  REST endpointGET https://cotlet.dev/api/v1/mews/customers/find

  Parameters

  Parameters: find_customer

  Name	Type	Description
  query string required	string	Guest name or part of it.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "customers": [
      {
        "customer_id": "e5f4a6b8-1f0c-4a5e-9c75-6d9b2f4a5e03",
        "name": "Lindgren, Eva",
        "email": "eva@example.com",
        "reservations": [
          {
            "reservation_id": "a1f0c2d4-7b6e-4c1a-9e31-2f5d8b0c1a01",
            "status": "Confirmed",
            "arrival": "2026-11-06"
          }
        ]
      }
    ]
  }

• get_customer A guest profile: contact details, Internals notes, reservations and open bills. read

  Returns the Profile fields (name, email, nationality, phone), the Internals tab (notes, dietary requirements, preferred space features) and the reservations and open bills the Dashboard and Billing tabs list. It does not return identity documents or payment details.

  MCP callmews_read → get_customer

  REST endpointGET https://cotlet.dev/api/v1/mews/customers/{customer_id}

  Parameters

  Parameters: get_customer

  Name	Type	Description
  customer_id string required	string	Customer ID from find_customer or a reservation.

  Example input

  {
    "customer_id": "customer_8c41d2"
  }

  Example response

  {
    "customer_id": "e5f4a6b8-1f0c-4a5e-9c75-6d9b2f4a5e03",
    "name": "Lindgren, Eva",
    "email": "eva@example.com",
    "nationality": "SE",
    "internals": {
      "notes": "Prefers a quiet room",
      "dietary_requirements": "Vegetarian",
      "preferred_space_features": "High floor"
    },
    "reservations": [
      {
        "reservation_id": "a1f0c2d4-7b6e-4c1a-9e31-2f5d8b0c1a01",
        "status": "Confirmed",
        "arrival": "2026-11-06",
        "departure": "2026-11-09"
      }
    ],
    "open_bills": 0
  }

ToolWhat it doesAccess

• add_reservation_note Add a note in the reservation's Notes section. writeasks first

  Adds the note to the reservation's Notes section, where staff read it and where it shows in reports that list reservation notes. Existing notes stay as they are. Staff can edit or delete a note in Mews. By default you confirm each call; you can switch that off for this tool.

  MCP callmews_write → add_reservation_note

  REST endpointPOST https://cotlet.dev/api/v1/mews/reservations/{reservation_id}/note

  Parameters

  Parameters: add_reservation_note

  Name	Type	Description
  reservation_id string required	string	Reservation ID from list_reservations, list_arrivals or list_departures.
  note string required	string	Note text for staff.

  Example input

  {
    "reservation_id": "reservation_8c41d2",
    "note": "note"
  }

  Example response

  {
    "reservation_id": "a1f0c2d4-7b6e-4c1a-9e31-2f5d8b0c1a01",
    "notes": [
      "Late arrival",
      "Vegetarian, quiet room"
    ]
  }

• create_task Create a task for an employee or a department, optionally linked to a reservation. writeasks first

  Creates the task as the Tasks donut on the Dashboard does. The assignee or department sees it on their Dashboard, or in the Tasks tab of the Mews Operations app. The department must already exist in Settings. By default you confirm each call; you can switch that off for this tool.

  MCP callmews_write → create_task

  REST endpointPOST https://cotlet.dev/api/v1/mews/tasks

  Parameters

  Parameters: create_task

  Name	Type	Description
  name string required	string	Task title.
  department string	string	Department responsible, by name. Use this or assignee.
  assignee string	string	Employee responsible, by name. Use this or department.
  reservation_id string	string	Attach the task to this reservation.

  Example input

  {
    "name": "Check-out missed: call guest",
    "department": "Front desk",
    "reservation_id": "b2e1d3c5-8c7f-4d2b-8f42-3a6e9c1d2b01"
  }

  Example response

  {
    "task_id": "f6a5b7c9-2a1d-4b6f-8d86-7e0c3a5b6f01",
    "name": "Check-out missed: call guest",
    "department": "Front desk",
    "reservation_id": "b2e1d3c5-8c7f-4d2b-8f42-3a6e9c1d2b01",
    "status": "open"
  }

• cancel_reservation Cancel a reservation from its Status tab. writeasks first

  Cancels a reservation that has not checked in and is still inside the property's editable history window. A reservation that is in house cannot be cancelled: shorten it and check the guest out instead. If the bill is closed, Mews creates a rebate to cancel it out. Needs the Create and manage reservations permission. By default you confirm each call; you can switch that off for this tool.

  MCP callmews_write → cancel_reservation

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

  Parameters

  Parameters: cancel_reservation

  Name	Type	Description
  reservation_id string required	string	Reservation ID from list_reservations, list_arrivals or list_departures.
  send_cancellation_email boolean	boolean	Email the customer about the cancellation. Defaults to the Send cancellation email by default setting of the service.

  Example input

  {
    "reservation_id": "reservation_8c41d2"
  }

  Example response

  {
    "reservation_id": "d4e3f5a7-0e9b-4f4d-8b64-5c8a1e3f4d01",
    "status": "Canceled",
    "cancellation_email_sent": false
  }