Skip to content
MCP server

Semble MCP by usefulapi

Read Semble patients, bookings, invoices and products; create patients and tasks, label…

Install
Runs
Remotely
Version
1.16.0
Listing updated
4 days ago

About Semble MCP by usefulapi

Semble MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read Semble patients, bookings, invoices and products; create patients and tasks, label patients.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://semble.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "semble": {
      "url": "https://semble.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": {
    "semble": {
      "type": "http",
      "url": "https://semble.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "semble": {
      "serverUrl": "https://semble.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "semble": {
      "type": "http",
      "url": "https://semble.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (19)

Read directly from the server.

semble_get_practice
The practice the API token belongs to: name, timezone, locations, appointment types and medical specialties. A good first call to check the connection.
semble_list_patients
Patients of the practice (personal and health data). `search` matches name, email, phone or date of birth. Returns id, name, date of birth, contact details and status, plus pageInfo.hasMore for the next page.
semble_get_patient
One patient by id (personal data): demographics, phones, address, numbers, custom attributes, labels, comments and status. Appointments, invoices and tasks have their own tools.
semble_list_patient_bookings
The bookings (appointments) of one patient between two dates, with doctor, location, appointment type and status. Both dates are required (YYYY-MM-DD).
semble_list_bookings
Bookings (appointments) of the whole practice. With a date range, a booking is included if it starts or ends inside it. Returns patient, doctor, location, appointment type, status and journey (arrived, consultation, departed, dna).
semble_get_booking
One booking by id, with patient, doctor, location, appointment type, status and journey.
semble_list_users
Staff users of the practice (clinicians and admin): name, email, role, qualifications and specialties. Use the ids for bookings and tasks.
semble_get_user
One staff user by id.
semble_list_products
The practice's price list: appointment types, services and stock items, with price, cost, duration and stock level. `search` matches the item code or name.
semble_get_product
One product, service or appointment type by id.
semble_list_invoices
Invoices whose invoice date is inside a date range, with patient, totals and what is outstanding. Filter by status (active or cancelled) and paid_or_outstanding. Monetary amounts are in the practice currency.
semble_get_invoice
One invoice by id, with its line items, totals and what is outstanding.
semble_list_contacts
Contacts of the practice (referring doctors, insurers and other payors). `search` matches name, email, phone, specialty and numbers.
semble_list_tasks
Practice tasks, filtered by patient, status, priority, type or assignee. Returns subject, due date, priority, assignee and patient.
semble_list_labels
The labels that can be put on patients (id, title, colour). Use the id with semble_add_patient_label.
semble_create_task
Creates a task in Semble assigned to a staff user (get ids from semble_list_users), optionally about a patient, with a due date, priority and type. Creates a new record each time it is called.
semble_update_task
Changes a task: close or reopen it (status), reassign it, move the due date, or edit subject, priority and notes. Only the fields you pass are changed.
semble_add_patient_label
Puts an existing label on a patient (label ids from semble_list_labels). Adds only; nothing is removed.
semble_create_patient
Creates a new patient record (personal data) from the details you give. It does not check for an existing patient: search with semble_list_patients first to avoid a duplicate.

Semble MCP by usefulapi FAQ

How do I add Semble MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http semble https://semble.usefulapi.io/mcp