MCP server
Nookal MCP by usefulapi
Read Nookal locations, practitioners, availability, appointments, clients, cases and…
- Runs
- Remotely
- Version
- 1.31.0
- Listing updated
- 4 days ago
About Nookal MCP by usefulapi
Nookal MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read Nookal locations, practitioners, availability, appointments, clients, cases and invoices.
Install
Run in a terminal
claude mcp add --transport http nookal https://nookal.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://nookal.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"nookal": {
"url": "https://nookal.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"nookal": {
"type": "http",
"url": "https://nookal.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"nookal": {
"serverUrl": "https://nookal.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"nookal": {
"type": "http",
"url": "https://nookal.usefulapi.io/mcp"
}
}
}Tools this server provides (11)
Read directly from the server.
- nookal_list_locations
- 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.
- nookal_list_staff
- 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.
- nookal_list_services
- 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.
- nookal_list_classes
- List the class types offered (id, name, category, duration, price, location, online-booking settings) — the class definitions, not individual sessions. Nookal GraphQL: classes.
- nookal_get_availability
- 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.
- nookal_list_appointments
- 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.
- nookal_search_clients
- 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.
- nookal_get_client
- 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.
- nookal_list_cases
- List treatment cases (id, client, title, start and referral dates, referrer, primary practitioner, notes), filtered by client, case or practitioner. Nookal GraphQL: cases.
- nookal_list_invoices
- 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.
- nookal_list_payments
- List payments received against invoices (method, amount, date, reference, invoice, client, location), filtered by invoice or payment date. Nookal GraphQL: payments.
Nookal MCP by usefulapi FAQ
How do I add Nookal MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http nookal https://nookal.usefulapi.io/mcp