# ByDoctor MCP by usefulapi

> ByDoctor MCP by usefulapi is an MCP server. Read appointments, professionals and rooms; book, update and cancel visits in ByDoctor. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read appointments, professionals and rooms; book, update and cancel visits in ByDoctor.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `bydoctor_list_appointments`: List clinic appointments, oldest update first, with filters for date range, status, modality, professional, patient and room. Use updated_since to sync only what changed. Returns results[] plus next/previous cursor URLs. GET /appointments.
- `bydoctor_get_appointment`: Get one appointment by its UUID id, with patient, professional, room, type, status and times. GET /appointments/{id}.
- `bydoctor_list_patients`: Find clinic patients by exact CPF or phone, or by partial name. CPF, e-mail, birth date and gender are never returned. Use this before creating an appointment to avoid duplicate patients. GET /patients.
- `bydoctor_get_patient`: Get one patient by id: name, phone, active flag and timestamps. GET /patients/{id}.
- `bydoctor_list_professionals`: List the active professionals who see patients: id, name and main specialty. Use the id as professional_id. GET /professionals.
- `bydoctor_get_professional`: Get one active professional by id: name and specialty. GET /professionals/{id}.
- `bydoctor_list_rooms`: List the active clinic rooms: id and name. Empty when the clinic does not use rooms. Use the id as room_id. GET /rooms.
- `bydoctor_get_room`: Get one active room by id: name. GET /rooms/{id}.
- `bydoctor_list_appointment_types`: List the active appointment types, such as consultation or follow-up: id and name. Use the id as appointment_type_id. GET /appointment-types.
- `bydoctor_get_appointment_type`: Get one active appointment type by id: name. GET /appointment-types/{id}.
- `bydoctor_create_appointment`: WRITE: books a new in-person appointment with status scheduled, for an existing patient, professional and appointment type. Teleconsults are not created by the API. Needs the appointments:write scope. POST /appointments.
- `bydoctor_update_appointment`: WRITE: changes only the fields you send: start_at, professional_id, room_id, note, or status (scheduled or confirmed only). A confirmed appointment accepts only a status change; move it back to scheduled first to reschedule. Needs appointments:write. PATCH /appointments/{id}.
- `bydoctor_cancel_appointment`: WRITE: cancels an in-person appointment that is scheduled (move a confirmed one back to scheduled first). Repeating the cancel returns the same result. Needs appointments:write. POST /appointments/{id}/cancel.
- `bydoctor_create_patient`: WRITE: creates a patient record and returns its id for bydoctor_create_appointment. Search by CPF or phone first to avoid duplicates; a CPF already used by another patient in the clinic is refused (409). Needs patients:write. POST /patients.
- `bydoctor_update_patient`: WRITE: changes only the fields you send. Send null to clear phone, email, cpf or birth_date; name and gender cannot be cleared. A CPF used by another patient is refused (409). Needs patients:write. PATCH /patients/{id}.

## FAQ

### How do I add ByDoctor MCP by usefulapi to Claude Code?

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

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