Mcp Ratchet Clinical Charting

mcp-ratchet-clinical-charting

MCP server for clinical charting with Claude (codename: Ratchet) - Enables Claude to document patient visits directly into Electronic Medical Records, reducing administrative burden for home health nurses.

Note: Currently runs in Mock Mode for development/testing. Production EMR integration coming soon.

Status

Current Mode: Mock Mode - Uses realistic test data for development and testing.

Quick Start

From npm (Recommended)

npx mcp-ratchet-clinical-charting

From Source

git clone https://github.com/m2ai-mcp-servers/mcp-ratchet-clinical-charting.gitcd mcp-ratchet-clinical-chartingnpm installnpm run buildnpm run dev  # Development modenpm test     # Run tests

Mock Mode

Ratchet runs in mock mode by default when POINTCARE_API_URL is not configured. Mock mode:

• Uses 5 fictional test patients
• Stores visit notes in memory
• Returns realistic responses
• Perfect for development and Claude Desktop testing

Available Tools

Example Usage (in Claude)

"Search for patient Eleanor Thompson"→ Returns patient PT-10001 with demographics and status
"Create a visit note for PT-10001 with blood pressure 120/80"→ Creates and stores visit note with vitals
"Get visit history for PT-10001"→ Returns list of previous visits

Claude Desktop Integration

Configure Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{  "mcpServers": {    "ratchet": {      "command": "npx",      "args": ["-y", "mcp-ratchet-clinical-charting"]    }  }}

For production mode with EMR integration:

{  "mcpServers": {    "ratchet": {      "command": "npx",      "args": ["-y", "mcp-ratchet-clinical-charting"],      "env": {        "POINTCARE_API_URL": "https://api.pointcare.com",        "POINTCARE_API_KEY": "your-api-key"      }    }  }}

Step 3: Restart Claude Desktop

Restart Claude Desktop to load the new MCP server.

Step 4: Verify

In Claude Desktop, you should see:

• search_patient tool available
• create_visit_note tool available
• get_patient_history tool available

Try: "Search for patient Eleanor"

Test Patients (Mock Mode)

Origin Story

Ratchet evolved from the M2AI NurseCall n8n workflow, built to help home health nurses with visit documentation:

Current Flow (M2AI NurseCall):┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐│ Twilio  │───>│  n8n    │───>│  VAPI   │───>│  Email  ││  SMS    │    │ Workflow│    │  Call   │    │ Summary │└─────────┘    └─────────┘    └─────────┘    └─────────┘

The Problem: Visit notes go to email but still need manual entry into PointCare EMR.

Ratchet's Solution:

Future Flow (with Ratchet):┌─────────┐    ┌─────────┐    ┌──────────┐    ┌───────────┐│ Twilio  │───>│  n8n    │───>│ Ratchet  │───>│ PointCare ││  SMS    │    │ Workflow│    │   MCP    │    │    EMR    │└─────────┘    └─────────┘    └──────────┘    └───────────┘

Configuration

*Required for production use. Mock mode activates when not set.

Project Structure

ratchet/├── src/│   ├── index.ts              # MCP server entry point│   ├── config.ts             # Configuration management│   ├── tools/                # Tool implementations│   │   ├── search-patient.ts│   │   ├── create-visit-note.ts│   │   └── get-patient-history.ts│   ├── services/             # Business logic│   │   ├── patient-service.ts│   │   └── mock-data.ts│   ├── types/                # TypeScript types│   └── utils/                # Logger, errors├── tests/│   └── patient-service.test.ts├── dist/                     # Compiled output├── prds/│   └── RATCHET-PRD.yaml├── docs/│   └── API_REQUIREMENTS.md├── package.json├── tsconfig.json└── jest.config.js

Development

# Run in watch modenpm run dev
# Run testsnpm test
# Run tests with coveragenpm test -- --coverage
# Lintnpm run lint

Next Steps

1. Acquire PointCare API documentation - See docs/API_REQUIREMENTS.md
2. Complete PRD - Fill in tool specifications with real API details
3. Implement real API calls - Replace mock responses
4. Integration testing - Test with PointCare sandbox

Related Projects

• GRIMLOCK - Autonomous MCP Server Factory
• ratchet-demo-emr - Demo EMR React app for testing

License

MIT

Built with GRIMLOCK - Autonomous MCP Server Factory