# Semble MCP by usefulapi

> Semble MCP by usefulapi is an MCP server. Read Semble patients, bookings, invoices and products; create patients and tasks, label patients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/semble/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/semble
- **MCP Registry name:** io.usefulapi/semble
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://semble.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "semble": {
      "url": "https://semble.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "semble": {
      "type": "http",
      "url": "https://semble.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/semble-mcp-by-usefulapi
