open-dental-mcp

open-dental-mcp

Model Context Protocol (MCP) server for Open Dental — dental practice management software.

Talk to your Open Dental data from Claude, Cursor, or any MCP client. Read patients, appointments, providers, procedures, recalls. Write communications (phone calls, messages) back to patient charts.

Built against the Open Dental REST API. No existing MCP for Open Dental — this is the first.

What you can do with it

You:   "Pull patient 4523 and show me their last 5 appointments + outstanding recalls."
Claude: *calls get_patient, then find_appointments, then find_recalls*

You:   "Find every recall due this month and draft a friendly reminder for each."
Claude: *calls find_recalls with due_date window, drafts the messages*

You:   "Just got off a call with the Smith family about rescheduling — log it."
Claude: *calls log_communication with the right comm_type + comm_mode*

You:   "What providers are working at clinic 2 tomorrow?"
Claude: *calls list_providers + find_appointments, filters*

Install

pip install -e .

Configure

You need two API keys from Open Dental's Developer Portal:

1. Developer API Key — applies to your integration (you register via [email protected])
2. Customer API Key — generated per-customer in the Developer Portal

export OPENDENTAL_DEVELOPER_KEY="..."
export OPENDENTAL_CUSTOMER_KEY="..."

Who uses this server?

1. Approved Open Dental API Partners building tools for dental practices. Your developer key + customer keys work directly.
2. Dental practices / DSOs doing custom integration work. Email [email protected] to get set up.

Use with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "open_dental_mcp": {
      "command": "open_dental_mcp",
      "env": {
        "OPENDENTAL_DEVELOPER_KEY": "your-developer-key",
        "OPENDENTAL_CUSTOMER_KEY": "your-customer-key"
      }
    }
  }
}

Tools

Common patterns

Pre-visit brief

User:  I'm seeing patient 4523 at 2pm. Brief me.
Agent: get_patient(patnum=4523)
       find_appointments(patnum=4523, limit=5)
       find_procedurelogs(patnum=4523, limit=10)
       find_recalls(patnum=4523)
       → Summary: patient info, last visits, what's been done, what's due

Recall campaign

User:  Build this week's recall list and draft rebooking messages.
Agent: find_recalls(due_date_start="2026-06-26", due_date_end="2026-07-03")
       → for each: pull patient, draft a friendly message

Post-call documentation

User:  Just took a call from the Smiths about rescheduling next week's cleaning.
Agent: find_patients(lname="Smith", fname="...", phone="...")
       log_communication(
         patnum=<found>,
         comm_datetime="2026-06-26T15:30:00",
         comm_type=1,           # ApptRelated
         comm_mode=2,           # Phone
         sent_or_received=1,    # Received
         note="Patient called to reschedule cleaning. Will call back with new date."
       )

API coverage

Full Open Dental API: https://www.opendental.com/site/apispecification.html

Development

pip install -e ".[dev]"
pytest
open_dental_mcp

Need a custom MCP for your SaaS?

I build production-grade MCP servers for vertical SaaS — insurance, dental, veterinary, legal, property mgmt, home services. Typical engagement: 2-4 weeks, $25K-$120K. Source-owned, MIT-licensed, no vendor lock-in.

See sanjibani/mcp-services or email [email protected].

Ships in the sanjibani vertical-MCP portfolio — see also hawksoft-mcp, open-dental-mcp, ezyvet-mcp, jobber-mcp, paid-skills, mcp-vertical-template.

MIT — see LICENSE.

Acknowledgements

• Open Dental for the public REST API
• Built using mcp-vertical-template
• Inspired by sanjibani/hawksoft-mcp (insurance vertical, same pattern)

See also

• Open Dental API docs
• Open Dental Developer Portal
• Model Context Protocol
• MCP Python SDK
• More vertical MCPs from sanjibani