What is Mcp Scheduler Bot

mcp-scheduler-bot is a chatbot designed to manage appointments within the PracticeFusion platform, utilizing the Model Context Protocol (MCP) server to facilitate interactions through various MCP clients.

Use cases

Use cases for mcp-scheduler-bot include searching for patients, creating and updating patient records, managing appointment schedules, and providing clinical analysis to healthcare professionals.

How to use

To use mcp-scheduler-bot, clone the repository, set up your environment variables in a .env file with your PracticeFusion API credentials, and run the server locally. You can also integrate it with Claude Desktop for enhanced functionality.

Key features

Key features include access to PracticeFusion tools via API, OAuth2 authentication, integration with Anthropic Claude Desktop, response caching, error handling, null-safe data formatting, and comprehensive clinical analysis.

Where to use

mcp-scheduler-bot is primarily used in healthcare settings, specifically for managing patient appointments and interactions within the PracticeFusion ecosystem.

Practice Fusion MCP Server

A Model Context Protocol (MCP) server that provides healthcare tools and prompts for interacting with Practice Fusion using any MCP Client.

Features

• Practice Fusion tools via API
• Uses OAuth2 to authenticate with Practice Fusion
• Anthropic Claude Desktop integration
• Response caching
• Error handling
• Null-safe data formatting
• Comprehensive clinical analysis

Tools

Practice Fusion API Tools

• get_users - Get all users in the Practice Fusion practice
• get_facilities - Get all facilities in the Practice Fusion practice
• search_patients - Search for patients by name, DOB, or other identifiers
• get_patient_v4 - Get patient details using the v4 API
• create_patient_v4 - Create a new patient in Practice Fusion
• update_patient_v4 - Update an existing patient in Practice Fusion
• And many more Practice Fusion API operations

Development Configuration

For local testing, create a .env file in the root directory with the following variables:

# Practice Fusion API credentials
PF_CLIENT_ID=your_client_id
PF_CLIENT_SECRET=your_client_secret

# API URLs
PF_API_URL=https://api.practicefusion.com

# OAuth settings
PF_TOKEN_PATH=/ehr/oauth2/token
PF_AUTHORIZE_PATH=/ehr/oauth2/auth
PF_CALLBACK_URL={{your redirect uri}}


# Practice Fusion API scopes
PF_SCOPES=calendar:a_confirmation_v1 calendar:a_events_v1 calendar:a_events_v2 ... etc


## Start MCP Server Locally 

git clone {practice-fusion-mcp-github path}
cd practice-fusion-mcp
npm install

Create .env file with your credentials

npm run build

## Use with Claude Desktop

For Claude Desktop, update your configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
“mcpServers”: {
“filesystem”: {
“command”: “npx”,
“args”: [
“-y”,
“@modelcontextprotocol/server-filesystem”,
“/Users/your-username/Desktop”
]
},
“practice-fusion-mcp”: {
“command”: “node”,
“args”: [
“/Users/your-username/{download-path}/practice-fusion-mcp-server/build/index.js”
],
“env”: {
“NODE_ENV”: “production”
}
}
}
}

Just so you know, you no longer need to include sensitive credentials in the Claude Desktop configuration. All credentials are stored and loaded from the `.env` file on the server.

## Use MCP Inspector
(MCP Server using inspector. Make sure to update the .env file with the correct values.)

npm install -g @modelcontextprotocol/inspector
mcp-inspector build/index.js
http://localhost:5173

## Troubleshooting:
If Claude desktop is running it uses port 3456 for Auth. You need to terminate that process using the following command:

kill -9 $(lsof -t -i:3456)