MCP server
Semble MCP by usefulapi
Read Semble patients, bookings, invoices and products; create patients and tasks, label…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://semble.usefulapi.io/mcpInstall 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