Open Dental MCP by usefulapi
Read appointments, open slots, providers, procedure codes and recalls in Open Dental.
使うべきか
品質と安全性
検出事項（3）
- LOWTool 'opendental_list_asap_appointments' name length outside 3-30 rangeopendental_list_asap_appointments 内
- LOWTool 'opendental_list_appointment_types' name length outside 3-30 rangeopendental_list_appointment_types 内
- LOWTool 'opendental_list_procedure_codes' name length outside 3-30 rangeopendental_list_procedure_codes 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"open-dental": {
"url": "https://open-dental.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://open-dental.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール（17）
🟢opendental_get_api_permissions
The API permissions this customer key has (ReadAll, Appointments, Patients, ...), each true or false. The tools here only read, so ReadAll is the one they need. Use it to explain why a call is refused. GET /securityperms.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_patients(last_name, first_name, status, birthdate, guarantor, ...)
List patients with the fast search (name, birthdate, status, guarantor, primary provider, clinic, changed since). Names match partially, case-insensitive. Returns demographics, balances and contact data (protected health information); SSNs are removed. Page with limit/offset. GET /patients/Simple.
入力スキーマ
{
"type": "object",
"properties": {
"last_name": {
"description": "Last name or the start of it.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"first_name": {
"description": "First name or the start of it.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"status": {
"description": "Patient status. Omit for all.",
"type": "string",
"enum": [
"Patient",
"NonPatient",
"Inactive",
"Archived",
"Deceased",
"Prospective"
]
},
"birthdate": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"guarantor": {
"description": "PatNum of the guarantor (the person responsible for the account): lists a family.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"primary_provider": {
"description": "ProvNum of the primary provider.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"clinic": {
"description": "ClinicNum. Omit for all clinics.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_search_patients(last_name, first_name, phone, email, address, ...)
Search patients the way Open Dental's Patient Select window does: by name, phone, email, address, city, state, chart number, birthdate or insurance subscriber id. Slower than opendental_list_patients on large databases; use it for phone, email and address lookups. Returns the Patient Select columns only (use opendental_get_patient for the full record). GET /patients.
入力スキーマ
{
"type": "object",
"properties": {
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"phone": {
"description": "Any of the patient's phone numbers.",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"email": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"address": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"state": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"chart_number": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"birthdate": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"subscriber_id": {
"description": "Insurance subscriber id.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"hide_inactive": {
"description": "Hide inactive patients.",
"type": "boolean"
},
"guarantors_only": {
"description": "Only guarantors.",
"type": "boolean"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_get_patient(patient_id)
One patient's full record by PatNum: name, status, birthdate, contact details, balances, providers, preferred contact methods, urgent notes. SSN is removed. GET /patients/{PatNum}.
入力スキーマ
{
"type": "object",
"properties": {
"patient_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "PatNum."
}
},
"required": [
"patient_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_get_patient_notes(patient_id)
A patient's note fields: family financial, medical, service, medical complete, treatment (odontogram) notes and the emergency contact (ICE name and phone). GET /patientnotes/{PatNum}.
入力スキーマ
{
"type": "object",
"properties": {
"patient_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "PatNum."
}
},
"required": [
"patient_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_appointments(patient_id, status, operatory, date, date_start, ...)
List appointments, filtered by patient, status, operatory, a day or a date range, clinic, appointment type, or changed since. Each has AptNum, PatNum, status, AptDateTime, pattern, provider, operatory, note and procedures. Use `date` for one day (e.g. today's schedule) or date_start/date_end for a range. GET /appointments.
入力スキーマ
{
"type": "object",
"properties": {
"patient_id": {
"description": "PatNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"status": {
"type": "string",
"enum": [
"Scheduled",
"Complete",
"UnschedList",
"ASAP",
"Broken",
"Planned",
"PtNote",
"PtNoteCompleted"
]
},
"operatory": {
"description": "OperatoryNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"date": {
"description": "One day.",
"type": "string"
},
"date_start": {
"description": "Range start, inclusive.",
"type": "string"
},
"date_end": {
"description": "Range end, inclusive.",
"type": "string"
},
"clinic": {
"description": "ClinicNum; 0 = appointments not attached to a clinic.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"appointment_type": {
"description": "AppointmentTypeNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_get_appointment(appointment_id)
One appointment by AptNum, with its patient, time, provider, operatory, status, confirmation, note and procedures. GET /appointments/{AptNum}.
入力スキーマ
{
"type": "object",
"properties": {
"appointment_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "AptNum."
}
},
"required": [
"appointment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_asap_appointments(clinic, provider, limit, offset)
The ASAP list: appointments whose priority is ASAP (patients who want an earlier time). ClinicNum is required when the office uses clinics (use 0 for no clinic). GET /appointments/ASAP.
入力スキーマ
{
"type": "object",
"properties": {
"clinic": {
"description": "ClinicNum; 0 = not attached to a clinic. Required if clinics are enabled.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"provider": {
"description": "ProvNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_find_open_slots(date, date_start, date_end, length_minutes, provider, ...)
Open schedule slots for a provider and operatory (like the Appointments module search): each has DateTimeStart, DateTimeEnd, ProvNum and OpNum. Dates must be today or later; the default is the next 14 days. GET /appointments/Slots.
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"description": "One day (today or later).",
"type": "string"
},
"date_start": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"date_end": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"length_minutes": {
"description": "Skip slots shorter than this many minutes.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1440
},
"provider": {
"description": "ProvNum (default: the practice default provider).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"operatory": {
"description": "OperatoryNum the provider is assigned to.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_providers(clinic, changed_since, limit, offset)
Providers (dentists, hygienists, billing entities) with ProvNum, abbreviation, name, specialty, status and hidden flags. SSN/TIN is removed. Optionally only providers usable at one clinic, or only those changed since a time (not both). GET /providers.
入力スキーマ
{
"type": "object",
"properties": {
"clinic": {
"description": "ClinicNum: non-hidden providers not restricted to another clinic.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_operatories(clinic, limit, offset)
Operatories (treatment rooms) with OperatoryNum, name, abbreviation, assigned dentist and hygienist, clinic and hidden flag. GET /operatories.
入力スキーマ
{
"type": "object",
"properties": {
"clinic": {
"description": "ClinicNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_clinics(limit, offset)
All non-hidden clinics (locations) with address, billing address and phone. An empty list means the office does not use the Clinics feature. GET /clinics.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_appointment_types(limit, offset)
Appointment types (AppointmentTypeNum, name, default pattern, required procedure codes, hidden flag). GET /appointmenttypes.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_procedure_codes(changed_since, limit, offset)
The office's procedure codes (CodeNum, ADA code, description, category, treatment area, hygiene flag). Use CodeNum to filter procedure logs. Page with limit/offset. GET /procedurecodes.
入力スキーマ
{
"type": "object",
"properties": {
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_procedure_logs(patient_id, appointment_id, procedure_date, status, clinic, ...)
Procedure log entries (treatment-planned, complete, existing, referred, deleted) filtered by patient, appointment, date, status, clinic, procedure code or creation time. Each has ProcNum, PatNum, ProcDate, fee, tooth, surface, status, provider and code. Page with limit/offset. GET /procedurelogs.
入力スキーマ
{
"type": "object",
"properties": {
"patient_id": {
"description": "PatNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"appointment_id": {
"description": "AptNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"procedure_date": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"status": {
"description": "TP treatment plan, C complete, EC/EO existing, R referred out, D deleted, Cn condition, TPi inactive TP.",
"type": "string",
"enum": [
"TP",
"C",
"EC",
"EO",
"R",
"D",
"Cn",
"TPi"
]
},
"clinic": {
"description": "ClinicNum.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"code_num": {
"description": "CodeNum from opendental_list_procedure_codes.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"created_since": {
"description": "Procedures created on or after this time.",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_commlogs(patient_id, changed_since, limit, offset)
Communication log entries (calls, texts, emails, letters) for a patient or changed since a time: CommlogNum, PatNum, date, mode, sent or received, note. Page with limit/offset. GET /commlogs.
入力スキーマ
{
"type": "object",
"properties": {
"patient_id": {
"description": "PatNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_recalls_due(date_start, date_end, provider, clinic, recall_type, ...)
The Recall List as in Open Dental's Appointment module: patients due for recall (prophy, perio) with due date, interval, reminders sent, last reminder, preferred contact and status. Defaults follow the office's recall preferences. Page with limit/offset. GET /recalls/List.
入力スキーマ
{
"type": "object",
"properties": {
"date_start": {
"description": "Due date range start.",
"type": "string"
},
"date_end": {
"description": "Due date range end.",
"type": "string"
},
"provider": {
"description": "ProvNum (primary or secondary provider).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"clinic": {
"description": "ClinicNum; 0 = unassigned.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"recall_type": {
"description": "Typically \"Prophy\" or \"Perio\".",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"include_reminded": {
"description": "Include patients who already received a reminder (default false).",
"type": "boolean"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス