Bokadirekt API and MCP server Let your AI agent run your Bokadirekt diary.

ToolWhat it doesAccess

• list_locations Locations (platser) of your Bokadirekt account. read

  Returns the locations of your business with the name Bokadirekt shows. Use location as the filter on the other tools when your account has more than one. A business with one location gets a list of one.

  MCP callbokadirekt_read → list_locations

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

  Parameters

  No parameters.

  Example response

  {
    "locations": [
      {
        "location": "Salong Eira Södermalm",
        "city": "Stockholm"
      }
    ]
  }

• list_staff Users (utövare) who take bookings, with the location they work at. read

  Returns the users of your account who can be booked. Use staff_id to filter bookings and available times.

  MCP callbokadirekt_read → list_staff

  REST endpointGET https://cotlet.dev/api/v1/bokadirekt/staffs

  Parameters

  Parameters: list_staff

  Name	Type	Description
  location string	string	Only staff of this location.

  Example response

  {
    "staff": [
      {
        "staff_id": "st_101",
        "name": "Elin Berg",
        "location": "Salong Eira Södermalm"
      },
      {
        "staff_id": "st_102",
        "name": "Sara Lind",
        "location": "Salong Eira Södermalm"
      }
    ]
  }

• list_services Services (tjänster) with duration and price. read

  Returns the bookable services of your account with their length in minutes and price. Use service_id in find_available_times and create_booking.

  MCP callbokadirekt_read → list_services

  REST endpointGET https://cotlet.dev/api/v1/bokadirekt/services

  Parameters

  Parameters: list_services

  Name	Type	Description
  location string	string	Only services offered at this location.

  Example response

  {
    "services": [
      {
        "service_id": "sv_21",
        "name": "Klippning dam",
        "minutes": 45,
        "price": 595
      },
      {
        "service_id": "sv_22",
        "name": "Färg och klipp",
        "minutes": 120,
        "price": 1490
      }
    ]
  }

ToolWhat it doesAccess

• find_available_times Free times for a service, as the calendar suggests them. read

  Returns the free start times Bokadirekt proposes for one service when you pick it in the calendar, in the time order of the calendar. The length of the service and any gap after it are respected. Pick staff_id to see one person only.

  MCP callbokadirekt_read → find_available_times

  REST endpointGET https://cotlet.dev/api/v1/bokadirekt/services/{service_id}/available-times/find

  Parameters

  Parameters: find_available_times

  Name	Type	Description
  service_id string required	string	Service from list_services.
  date date required	date	First day to search.
  staff_id string	string	Only this staff member.

  Example input

  {
    "service_id": "service_8c41d2",
    "date": "2026-10-01"
  }

  Example response

  {
    "times": [
      {
        "staff_id": "st_102",
        "start": "2026-11-06T10:00:00+01:00"
      },
      {
        "staff_id": "st_102",
        "start": "2026-11-06T13:30:00+01:00"
      }
    ]
  }

• list_bookings Bookings in a date range from the booking list, with customer, service, staff and status. read

  Returns the bookings the Lista view shows for the dates you pick, with cancelled ones marked. type narrows the list the way the Filter panel does. Results come in start order. Use booking_id with get_booking, move_booking and cancel_booking.

  MCP callbokadirekt_read → list_bookings

  REST endpointGET https://cotlet.dev/api/v1/bokadirekt/bookings

  Parameters

  Parameters: list_bookings

  Name	Type	Description
  from date required	date	First day.
  to date required	date	Last day.
  type enum	enum	all, cancelled, no_show, new_customer, last_minute, internal or online (made on Bokadirekt.se). Default: all.
  staff_id string	string	Only this staff member.
  service_id string	string	Only this service.

  Example input

  {
    "from": "2026-10-01",
    "to": "2026-10-01"
  }

  Example response

  {
    "bookings": [
      {
        "booking_id": "bk_5501",
        "customer": "Anna Ek",
        "service": "Klippning dam",
        "staff": "Elin Berg",
        "start": "2026-11-06T09:00:00+01:00",
        "price": 595,
        "status": "booked",
        "source": "bokadirekt.se"
      },
      {
        "booking_id": "bk_5502",
        "customer": "Maja Holm",
        "service": "Färg och klipp",
        "staff": "Elin Berg",
        "start": "2026-11-06T11:00:00+01:00",
        "price": 1490,
        "status": "booked",
        "source": "internal"
      }
    ]
  }

• get_booking One booking with its note, customer, service and payment status. read

  Returns the details of one booking as the booking card shows them, including the booking note and whether the customer paid online. A booking with several services returns one line per service.

  MCP callbokadirekt_read → get_booking

  REST endpointGET https://cotlet.dev/api/v1/bokadirekt/bookings/{booking_id}

  Parameters

  Parameters: get_booking

  Name	Type	Description
  booking_id string required	string	Booking from list_bookings.

  Example input

  {
    "booking_id": "booking_8c41d2"
  }

  Example response

  {
    "booking_id": "bk_5501",
    "customer": "Anna Ek",
    "customer_id": "cu_880",
    "service": "Klippning dam",
    "staff": "Elin Berg",
    "start": "2026-11-06T09:00:00+01:00",
    "minutes": 45,
    "price": 595,
    "status": "booked",
    "note": "Vill ha kortare lugg"
  }

• create_booking Book a customer on a service at a time, as Ny bokning does. writeasks first

  Creates a booking for an existing customer on one service with one staff member. The booking is made from your signed-in user, so the booking margin does not apply. Bokadirekt sends the customer a confirmation according to your settings. By default you confirm each call; you can switch that off for this tool.

  MCP callbokadirekt_write → create_booking

  REST endpointPOST https://cotlet.dev/api/v1/bokadirekt/customers/{customer_id}/bookings

  Parameters

  Parameters: create_booking

  Name	Type	Description
  customer_id string required	string	Customer from list_customers.
  service_id string required	string	Service from list_services.
  staff_id string required	string	Staff member from list_staff.
  start datetime required	datetime	Start time, ISO 8601, from find_available_times.

  Example input

  {
    "customer_id": "cu_912",
    "service_id": "sv_21",
    "staff_id": "st_102",
    "start": "2026-11-06T10:00:00+01:00"
  }

  Example response

  {
    "booking_id": "bk_5530",
    "status": "booked",
    "start": "2026-11-06T10:00:00+01:00",
    "customer": "Maja Holm",
    "service": "Klippning dam",
    "staff": "Sara Lind"
  }

• move_booking Change the time or the staff member of a booking. writeasks first

  Changes the start time, the staff member or both on an existing booking, as the booking card does. The original booking does not stay behind. It changes a customer's appointment, so you confirm it. By default you confirm each call; you can switch that off for this tool.

  MCP callbokadirekt_write → move_booking

  REST endpointPOST https://cotlet.dev/api/v1/bokadirekt/bookings/{booking_id}/move

  Parameters

  Parameters: move_booking

  Name	Type	Description
  booking_id string required	string	Booking from list_bookings.
  start datetime	datetime	New start time, ISO 8601.
  staff_id string	string	New staff member.

  Example input

  {
    "booking_id": "booking_8c41d2"
  }

  Example response

  {
    "booking_id": "bk_5502",
    "status": "booked",
    "start": "2026-11-07T11:00:00+01:00",
    "staff": "Sara Lind"
  }

• cancel_booking Cancel a customer's booking (Avboka). writeasks first

  Cancels one booking as Avboka does. Bokadirekt confirms the cancellation to the customer according to your settings. The cancellation margin does not apply to your own user. A cancelled booking stays in list_bookings with status cancelled. By default you confirm each call; you can switch that off for this tool.

  MCP callbokadirekt_write → cancel_booking

  REST endpointPOST https://cotlet.dev/api/v1/bokadirekt/bookings/{booking_id}/cancel

  Parameters

  Parameters: cancel_booking

  Name	Type	Description
  booking_id string required	string	Booking from list_bookings.

  Example input

  {
    "booking_id": "booking_8c41d2"
  }

  Example response

  {
    "booking_id": "bk_5502",
    "status": "cancelled"
  }

ToolWhat it doesAccess

• list_customers Customers (kundregister), searchable by name, email or phone. read

  Searches the customer register, which is shared by all locations and users. Returns name, contact details and the date of the latest booking. Customers appear automatically when they book, so the register is also a list of everyone who has booked.

  MCP callbokadirekt_read → list_customers

  REST endpointGET https://cotlet.dev/api/v1/bokadirekt/customers

  Parameters

  Parameters: list_customers

  Name	Type	Description
  query string	string	Part of a name, email or phone number.

  Example response

  {
    "customers": [
      {
        "customer_id": "cu_880",
        "name": "Anna Ek",
        "email": "anna@example.com",
        "last_booking": "2026-10-14"
      }
    ]
  }

• get_customer A customer card: details, booking history and notes. read

  Returns what the customer card shows: contact details, past and future bookings and the notes you saved. Also says whether the customer is blocked from booking online.

  MCP callbokadirekt_read → get_customer

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

  Parameters

  Parameters: get_customer

  Name	Type	Description
  customer_id string required	string	Customer from list_customers.

  Example input

  {
    "customer_id": "customer_8c41d2"
  }

  Example response

  {
    "customer_id": "cu_880",
    "name": "Anna Ek",
    "email": "anna@example.com",
    "blocked_online": false,
    "bookings": [
      {
        "booking_id": "bk_5501",
        "start": "2026-11-06T09:00:00+01:00",
        "service": "Klippning dam"
      }
    ],
    "notes": [
      "Allergisk mot ammoniak"
    ]
  }

• list_waitlist Customers on the waitlist (väntelista) with the service and dates they want. read

  Returns the customers on your waitlist with the service, the staff member if one was chosen and the date range they gave. The calendar shows the same count for the dates in view.

  MCP callbokadirekt_read → list_waitlist

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

  Parameters

  No parameters.

  Example response

  {
    "waitlist": [
      {
        "customer": "Maja Holm",
        "customer_id": "cu_912",
        "service": "Klippning dam",
        "from": "2026-11-05",
        "to": "2026-11-09"
      }
    ]
  }

• send_booking_message Send an SMS or email to the customer of a booking. writeasks first

  Sends a confirmation, a reminder or your own text to the customer of one booking, as the SMS and Mail buttons on the booking card do. SMS costs extra in Bokadirekt; email is free. By default you confirm each call; you can switch that off for this tool.

  MCP callbokadirekt_write → send_booking_message

  REST endpointPOST https://cotlet.dev/api/v1/bokadirekt/bookings/{booking_id}/message

  Parameters

  Parameters: send_booking_message

  Name	Type	Description
  booking_id string required	string	Booking from list_bookings.
  channel enum required	enum	sms or email.
  kind enum required	enum	confirmation, reminder or custom.
  text string	string	The message, only for kind custom.

  Example input

  {
    "booking_id": "booking_8c41d2",
    "channel": "sms",
    "kind": "confirmation"
  }

  Example response

  {
    "booking_id": "bk_5501",
    "channel": "sms",
    "status": "sent"
  }