← Back to all guides

Cliniko Tools — Health Practice Management

Langoedge Team2 min read

What are the Cliniko Tools?

For health and medical practices utilizing Cliniko, Langoedge offers a complete suite of native tools. These tools empower your voice and text agents to act as virtual clinic receptionists — checking practitioner availability, searching patient records, scheduling new appointments, and managing cancellations.

[!IMPORTANT]
Prerequisite: Active Account Connection Required
Before your AI agents can check clinic availability, query patients, or manage bookings in Cliniko, you must supply and connect your Cliniko API Key on the Connect Page.
Without an active Cliniko credential connection, any execution step using cliniko_* tools will fail at runtime.


Available Cliniko Actions

Attach these tools to your graph nodes to automate front-desk clinic tasks.

1. Information Retrieval

Retrieve structural configurations from your Cliniko portal:

  • cliniko_list_businesses: Retrieves a list of physical clinic locations or business entities registered in the account.
  • cliniko_list_practitioners: Lists clinic doctors, therapists, and staff members.
  • cliniko_list_appointment_types: Lists defined service durations and booking categories (e.g. "Initial Consultation", "Standard Checkup").

2. Patient Management

Look up patient files to contextualize calls:

  • cliniko_search_patients: Searches patient records by name, email, or date of birth.
  • cliniko_get_patient: Retrieves detailed profile history of a single patient using their unique patient ID.

3. Availability Lookup

Find open appointment slots dynamically:

  • cliniko_get_available_times: Retrieves available booking times for a specific practitioner at a business location.
  • cliniko_get_available_times_all_practitioners: Checks calendar availability across all clinic practitioners to find the earliest open slot.

4. Appointment Booking & Updates

Create and modify appointments:

  • cliniko_book_appointment: Book a patient into a specific time slot under an appointment type.
  • cliniko_get_appointment: Retrieves details of an existing booking.
  • cliniko_list_patient_appointments: Lists all upcoming or past bookings for a patient.
  • cliniko_reschedule_appointment: Moves an appointment to a new date/time slot.
  • cliniko_cancel_appointment: Cancels a booked appointment.
  • cliniko_update_appointment_notes: Appends reception notes or call transcript summaries to the appointment logs.
  • cliniko_mass_reschedule_practitioner_day: Moves a practitioner's entire day of bookings to another day (e.g. in case of practitioner illness).

Frequently Asked Questions

How does the receptionist agent handle practitioner preferences?
The agent calls `cliniko_get_available_times` for the practitioner the customer requests. If no matching slots exist, it can call `cliniko_get_available_times_all_practitioners` to offer alternative options.
How are Cliniko credentials managed?
Connect your Cliniko API key on the **[Connect Page](/connect)**. Langoedge establishes a secure bridge to your Cliniko shard domain (`https://your-shard.cliniko.com`) automatically.
LT

Langoedge Team

The Langoedge engineering team builds AI agent infrastructure that empowers businesses to deploy reliable, observable AI staff. Follow Langoedge Team on LinkedIn for product updates and architectural deep dives.