Skip to content
MCP server

ByDoctor MCP by usefulapi

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

Install
Runs
Remotely
Version
1.3.0
Listing updated
4 days ago

About ByDoctor MCP by usefulapi

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

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

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

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

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

Tools this server provides (15)

Read directly from the server.

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

ByDoctor MCP by usefulapi 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