Skip to content

Nookal MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.7.3 · published by io.usefulapi

Read Nookal locations, practitioners, availability, appointments, clients, cases and invoices.

Read only
CompareRegistry entry

11 tools: 11 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http nookal https://nookal.usefulapi.io/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

11 tools

Only reads 11Claude Code: allow
  • nookal_get_availabilityGet the free appointment slots per date between two dates (max 60 days, Nookal's limit), optionally for given locations, practitioners and a service.No findings

    Why it is in this group

    • The name "nookal_get_availability" says "get": a word for reading.
    Description, as the server wrote it
    Get the free appointment slots per date between two dates (max 60 days, Nookal's limit), optionally for given locations, practitioners and a service. Each slot has its date, start time (24h, clinic local time), provider id and location id. Read-only: it does not book anything. Nookal GraphQL: availabilities.

    Annotations the server declares

    • title: Get appointment availability
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_get_clientGet one client (patient) by id: name, date of birth, contact details, addresses, alerts, allergies, notes, occupation, referring doctor and their treatment cases; optionally a summ…No findings

    Why it is in this group

    • The name "nookal_get_client" says "get": a word for reading.
    Description, as the server wrote it
    Get one client (patient) by id: name, date of birth, contact details, addresses, alerts, allergies, notes, occupation, referring doctor and their treatment cases; optionally a summary of their invoices (totals and balances). Health-fund, pension and online-booking codes are not returned. Nookal GraphQL: clients.

    Annotations the server declares

    • title: Get a client (patient)
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_list_appointmentsList appointments (date, start/end time, status, type, client, practitioner, case, location, arrived / did-not-arrive flags, notes), filtered by date range, location, client, pract…No findings

    Why it is in this group

    • The name "nookal_list_appointments" says "list": a word for reading.
    Description, as the server wrote it
    List appointments (date, start/end time, status, type, client, practitioner, case, location, arrived / did-not-arrive flags, notes), filtered by date range, location, client, practitioner, type and status. Dates are clinic local. Nookal GraphQL: appointments.

    Annotations the server declares

    • title: List appointments
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_list_casesList treatment cases (id, client, title, start and referral dates, referrer, primary practitioner, notes), filtered by client, case or practitioner.No findings

    Why it is in this group

    • The name "nookal_list_cases" says "list": a word for reading.
    Description, as the server wrote it
    List treatment cases (id, client, title, start and referral dates, referrer, primary practitioner, notes), filtered by client, case or practitioner. Nookal GraphQL: cases.

    Annotations the server declares

    • title: List treatment cases
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_list_classesList the class types offered (id, name, category, duration, price, location, online-booking settings) — the class definitions, not individual sessions.No findings

    Why it is in this group

    • The name "nookal_list_classes" says "list": a word for reading.
    Description, as the server wrote it
    List the class types offered (id, name, category, duration, price, location, online-booking settings) — the class definitions, not individual sessions. Nookal GraphQL: classes.

    Annotations the server declares

    • title: List class types
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_list_invoicesList invoices with their line items and payments (number, client, case, location, practitioner, date, subtotal, tax, total, paid, balance), filtered by location, invoice id or crea…No findings

    Why it is in this group

    • The name "nookal_list_invoices" says "list": a word for reading.
    Description, as the server wrote it
    List invoices with their line items and payments (number, client, case, location, practitioner, date, subtotal, tax, total, paid, balance), filtered by location, invoice id or creation date. For one client's invoices use get_client with include_invoices. Nookal GraphQL: invoices.

    Annotations the server declares

    • title: List invoices
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_list_locationsList the clinic's locations (id, name, address, time zone, active).No findings

    Why it is in this group

    • The name "nookal_list_locations" says "list": a word for reading.
    Description, as the server wrote it
    List the clinic's locations (id, name, address, time zone, active). Location ids are needed by most other tools. Only the locations your API client was granted are returned. Nookal GraphQL: locations.

    Annotations the server declares

    • title: List locations
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_list_paymentsList payments received against invoices (method, amount, date, reference, invoice, client, location), filtered by invoice or payment date.No findings

    Why it is in this group

    • The name "nookal_list_payments" says "list": a word for reading.
    Description, as the server wrote it
    List payments received against invoices (method, amount, date, reference, invoice, client, location), filtered by invoice or payment date. Nookal GraphQL: payments.

    Annotations the server declares

    • title: List invoice payments
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_list_servicesList the appointment types / services offered (id, name, category, duration in minutes, price, location, online-booking settings).No findings

    Why it is in this group

    • The name "nookal_list_services" says "list": a word for reading.
    Description, as the server wrote it
    List the appointment types / services offered (id, name, category, duration in minutes, price, location, online-booking settings). Use a service id in get_availability. Nookal GraphQL: services.

    Annotations the server declares

    • title: List services (appointment types)
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_list_staffList staff members and practitioners (id, name, title, speciality, email, location ids, whether they are a provider / bookable online / active).No findings

    Why it is in this group

    • The name "nookal_list_staff" says "list": a word for reading.
    Description, as the server wrote it
    List staff members and practitioners (id, name, title, speciality, email, location ids, whether they are a provider / bookable online / active). Use the staff ids as provider_ids in list_appointments and staff_ids in get_availability. Nookal GraphQL: staff.

    Annotations the server declares

    • title: List practitioners and staff
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • nookal_search_clientsFind clients (patients) by name, date of birth, mobile, email or id.No findings

    Why it is in this group

    • The name "nookal_search_clients" says "search": a word for reading.
    Description, as the server wrote it
    Find clients (patients) by name, date of birth, mobile, email or id. Returns id, name, date of birth, location, active/deceased flags and contact details. With partial_match, names match on their first letters (e.g. 'Sm' finds Smith). Nookal GraphQL: clients.

    Annotations the server declares

    • title: Search clients (patients)
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.7.3. Values in angle brackets are yours to fill in.

claude mcp add --transport http nookal https://nookal.usefulapi.io/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__nookal__nookal_list_locations",
      "mcp__nookal__nookal_list_staff",
      "mcp__nookal__nookal_list_services",
      "mcp__nookal__nookal_list_classes",
      "mcp__nookal__nookal_get_availability",
      "mcp__nookal__nookal_list_appointments",
      "mcp__nookal__nookal_search_clients",
      "mcp__nookal__nookal_get_client",
      "mcp__nookal__nookal_list_cases",
      "mcp__nookal__nookal_list_invoices",
      "mcp__nookal__nookal_list_payments"
    ],
    "ask": [],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as nookal. Review it before you use it.