Latchkey

API & MCP

Connect your rooms to anything

Ask an AI assistant who's arriving today, have your website add direct bookings, or send guests a message from your own tools. One key works for both the MCP server (for AI assistants) and the REST API (for everything else).

10 actions
MCP · Streamable HTTP
REST · JSON · OpenAPI 3.1
Always up to date: generated from the live API

Start in 3 steps

  1. 1

    Turn it on

    The API and MCP server come with the Pro plan, or as an add-on to Start and Grow. Switch it on in Billing.

  2. 2

    Make a key

    In Settings → API & MCP, name a key and choose whether it can make changes. Copy it: it's shown once.

  3. 3

    Connect

    Paste it into your AI assistant or tool, using the steps below. That's it: try asking "Who's arriving today?"

Connect an AI assistant

Latchkey's MCP server works with any app that supports remote MCP servers over HTTP. Replace lk_… with your key.

Run this once in your terminal:

claude mcp add --transport http latchkey https://your-latchkey-address/api/public/mcp \
  --header "Authorization: Bearer lk_…"

What you can ask

  • "Which of my properties are set up in Latchkey?"

    List properties · list_properties
  • "How many rooms do I have at The Hill Suites, and how many people do they sleep?"

    List rooms · list_rooms
  • "Who is staying with me next week?"

    List bookings · list_bookings
  • "Has Priya Shah checked in yet?"

    Get a booking · get_booking
  • "Who's arriving today and who still needs to check out?"

    Today at a glance · todays_arrivals
  • "Book Sam Lee into the Garden Room from Friday for two nights, £180 paid."

    Add a direct booking · create_booking
    needs a key that can make changes
  • "Move Sam Lee to Suite 1 and add a note that they're arriving late."

    Change a booking · update_booking
    needs a key that can make changes
  • "Has anyone asked for anything I haven't dealt with?"

    Guest requests · list_requests
  • "Tell Priya the towels will be outside her door by 6pm."

    Message a guest · send_guest_message
    needs a key that can make changes
  • "How much of my Latchkey API allowance have I used?"

    Your API usage · get_usage

REST API

Base address https://your-latchkey-address/api/public/v1. Send your key in the Authorization: Bearer lk_… header. Requests and responses are JSON. The OpenAPI document imports into Postman, Zapier, Make, n8n and most tools.

GET
/properties
any key
MCP tool list_properties

List properties

Every property in your business, with its short link and check-in times.

curl "https://your-latchkey-address/api/public/v1/properties" \
  -H "Authorization: Bearer lk_…"
{
  "data": [
    {
      "id": "6f1c…",
      "name": "The Hill Suites",
      "short_code": "hill",
      "check_in_from": "15:00",
      "check_out_by": "11:00"
    }
  ]
}
GET
/properties/{property_id}/rooms
any key
MCP tool list_rooms

List rooms

The rooms in a property, with how many people each sleeps.

NameTypeWhat it does
property_id *uuid · pathThe property's id from List properties.
curl "https://your-latchkey-address/api/public/v1/properties/<property_id>/rooms" \
  -H "Authorization: Bearer lk_…"
{
  "data": [
    {
      "id": "2a9b…",
      "name": "Suite 1",
      "sleeps": 2,
      "children_allowed": true
    }
  ]
}
GET
/bookings
any key
MCP tool list_bookings

List bookings

Stays overlapping a date range, newest arrival first. Defaults to the next 30 days.

NameTypeWhat it does
property_iduuid · queryOnly this property.
fromdate · queryFirst night to include (YYYY-MM-DD). Default: today.
todate · queryLast night to include (YYYY-MM-DD). Default: 30 days on.
statusstring · queryOnly stays with this status.One of: needs_details, upcoming, checked_in, checked_out, cancelled, flagged, blocked
limitinteger · queryUp to 200. Default 50.
curl "https://your-latchkey-address/api/public/v1/bookings?from=2026-10-14&to=2026-11-13&limit=50" \
  -H "Authorization: Bearer lk_…"
{
  "data": [
    {
      "id": "b81e…",
      "property_id": "6f1c…",
      "room": "Suite 1",
      "guest_name": "Priya Shah",
      "check_in": "2026-10-16",
      "check_out": "2026-10-18",
      "nights": 2,
      "guests": 2,
      "status": "upcoming",
      "booked_on": "airbnb",
      "reference": "HM4K2P"
    }
  ]
}
GET
/bookings/{booking_id}
any key
MCP tool get_booking

Get a booking

One stay in full, including who's staying and whether they've checked in.

NameTypeWhat it does
booking_id *uuid · pathThe booking's id.
curl "https://your-latchkey-address/api/public/v1/bookings/<booking_id>" \
  -H "Authorization: Bearer lk_…"
{
  "data": {
    "id": "b81e…",
    "guest_name": "Priya Shah",
    "status": "checked_in",
    "checked_in_at": "2026-10-16T15:42:00Z",
    "adults": 2,
    "children": 0
  }
}
GET
/arrivals
any key
MCP tool todays_arrivals

Today at a glance

Who arrives, who leaves and who's staying on a given day (default today, in each property's time zone).

NameTypeWhat it does
datedate · queryThe day (YYYY-MM-DD). Default: today.
property_iduuid · queryOnly this property.
curl "https://your-latchkey-address/api/public/v1/arrivals" \
  -H "Authorization: Bearer lk_…"
{
  "data": {
    "date": "2026-10-14",
    "arriving": [
      {
        "guest_name": "Jean Dupont",
        "room": "Garden Room"
      }
    ],
    "leaving": [],
    "staying": []
  }
}
POST
/bookings
read + write key
MCP tool create_booking

Add a direct booking

Adds a stay booked directly with you (not through a booking site).

NameTypeWhat it does
property_id *uuid · bodyWhich property.
room_iduuid · bodyWhich room (from List rooms).
guest_name *string · bodyThe guest's full name.
check_in *date · bodyArrival date (YYYY-MM-DD).
check_out *date · bodyDeparture date (YYYY-MM-DD).
guestsinteger · bodyHow many people. Default 1.
emailstring · bodyThe guest's email, used to confirm who they are at check-in.
amountnumber · bodyWhat the guest paid, in your currency (e.g. 180.00). Used for invoices.
notesstring · bodyAnything to remember about the stay.
curl -X POST "https://your-latchkey-address/api/public/v1/bookings" \
  -H "Authorization: Bearer lk_…" \
  -H "Content-Type: application/json" \
  -d '{"property_id":"<id>","guest_name":"Sam Lee","check_in":"2026-10-17","check_out":"2026-10-17","guests":2}'
{
  "data": {
    "id": "c2d4…",
    "status": "upcoming"
  }
}
PATCH
/bookings/{booking_id}
read + write key
MCP tool update_booking

Change a booking

Changes a stay's guest details, room, status or notes. Only what you send is changed.

NameTypeWhat it does
booking_id *uuid · pathThe booking's id.
guest_namestring · bodyThe guest's full name.
emailstring · bodyThe guest's email.
room_iduuid · bodyMove to this room.
statusstring · bodyNew status.One of: upcoming, checked_in, checked_out, cancelled
notesstring · bodyReplaces the stay's notes.
curl -X PATCH "https://your-latchkey-address/api/public/v1/bookings/<booking_id>" \
  -H "Authorization: Bearer lk_…" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "data": {
    "id": "c2d4…",
    "status": "upcoming"
  }
}
GET
/requests
any key
MCP tool list_requests

Guest requests

Extras and problems guests have asked about, newest first.

NameTypeWhat it does
open_onlyboolean · queryOnly ones still waiting on you. Default true.
limitinteger · queryUp to 100. Default 30.
curl "https://your-latchkey-address/api/public/v1/requests?open_only=true" \
  -H "Authorization: Bearer lk_…"
{
  "data": [
    {
      "id": "9e…",
      "kind": "extras",
      "guest_name": "Priya Shah",
      "what": "2 × Fresh towels",
      "status": "new",
      "created_at": "2026-10-14T09:12:00Z"
    }
  ]
}
POST
/bookings/{booking_id}/messages
read + write key
MCP tool send_guest_message

Message a guest

Sends a message to the guest's stay page, as you.

NameTypeWhat it does
booking_id *uuid · pathThe booking's id.
message *string · bodyWhat to say (up to 2,000 characters).
curl -X POST "https://your-latchkey-address/api/public/v1/bookings/<booking_id>/messages" \
  -H "Authorization: Bearer lk_…" \
  -H "Content-Type: application/json" \
  -d '{"message":"…"}'
{
  "data": {
    "id": "m1…",
    "sent_at": "2026-10-14T10:03:00Z"
  }
}
GET
/usage
any key
MCP tool get_usage

Your API usage

Requests made this month and how many your plan includes.

curl "https://your-latchkey-address/api/public/v1/usage" \
  -H "Authorization: Bearer lk_…"
{
  "data": {
    "month": "2026-10",
    "requests": 1240,
    "included": 10000
  }
}

Errors

Errors come back as { "error": { "code": "…", "message": "…" } } with a message you can show as it is. Over MCP, the same message comes back as the tool's answer.

400bad_input, bad_dates, bad_roomSomething in the request needs fixing; the message says what.
401missing_key, bad_keyNo key, or a revoked one.
403read_only_key, not_on_plan, subscription_endedThe key can't make changes, the API isn't on the plan, or the account has ended.
404not_foundNothing with that id in your account.
429allowance_usedThis month's requests are used up; it resets on the 1st.
503api_pausedPaused for maintenance; try again shortly.

Limits and pricing

  • Start: add the API for £2 a month, with 10,000 requests
  • Grow: add the API for £2 a month, with 10,000 requests
  • Pro: 25,000 requests a month included

Every REST call and every MCP tool call counts as one request. Your usage shows in Settings → API & MCP. What changed and when is in What's new.