English Français العربية

SOAPNoteAPI

Official registry Health

Generate clinical SOAP notes, billing codes, and visit summaries from transcripts or audio.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package soapnoteapi-mcp
Claude Code 
claude mcp add soapnoteapi -e 'SOAPNOTEAPI_KEY=<your soapnoteapi_key>' -- npx -y soapnoteapi-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "soapnoteapi": {
            "command": "npx",
            "args": [
                "-y",
                "soapnoteapi-mcp@0.1.1"
            ],
            "env": {
                "SOAPNOTEAPI_KEY": "<your soapnoteapi_key>"
            }
        }
    }
}

Environment variables

  • SOAPNOTEAPI_KEY required secret SOAPNoteAPI Bearer key (snapi_sk_...). Get one at https://app.soapnoteapi.com

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. soapnoteapi-mcp
  2. Tools
  3. Setup
  4. Environment variables
  5. Develop
  6. Publish
  7. License

soapnoteapi-mcp

A Model Context Protocol (MCP) server for SOAPNoteAPI. It lets AI agents (Claude Desktop/Code, Cursor, Windsurf, VS Code + Copilot, etc.) turn clinical transcripts or audio recordings into structured SOAP notes, ICD-10/CPT billing-code suggestions, patient summaries, and visit summaries.

⚕️ All clinical content and billing codes are AI-generated decision support and must be reviewed by a qualified clinician/coder before use. HIPAA: this server only transits PHI to the API over TLS and never logs note content.

Tools

ToolWhat it doesAPI
list_specialtiesList supported specialties (no key needed)GET /v1/specialties
generate_soap_noteTranscript → SOAP note (+ optional billing codes, patient summary)POST /v1/note
get_noteFetch a note by noteIdGET /v1/note/{id}
summarize_visitsConsolidate visits into a longitudinal summaryPOST /v1/visit-summary
transcribe_audio_to_soapLocal audio file → SOAP note (waits for async jobs)PUT /v1/note/audio
get_audio_statusPoll an async audio jobGET /v1/audio/status/{id}

Setup

Get an API key at https://app.soapnoteapi.com (free tier: $10 credit, first 20 notes free).

Claude Desktop / Cursor (mcp.json)
{
  "mcpServers": {
    "soapnoteapi": {
      "command": "npx",
      "args": ["-y", "soapnoteapi-mcp"],
      "env": { "SOAPNOTEAPI_KEY": "snapi_sk_live_xxxxxxxx" }
    }
  }
}
Claude Code
claude mcp add soapnoteapi --env SOAPNOTEAPI_KEY=snapi_sk_live_xxxxxxxx -- npx -y soapnoteapi-mcp

Environment variables

VariableRequiredNotes
SOAPNOTEAPI_KEYyes (for all tools except list_specialties)Bearer key, snapi_sk_live_… or snapi_sk_test_…
SOAPNOTEAPI_BASE_URLnoOverride API base (default https://api.soapnoteapi.com)

Develop

pnpm install
pnpm --filter soapnoteapi-mcp dev     # run from source (tsx)
pnpm --filter soapnoteapi-mcp build   # compile to dist/
npx @modelcontextprotocol/inspector node dist/index.js   # interactive test

Publish

pnpm --filter soapnoteapi-mcp build
cd packages/mcp && npm publish        # publishes soapnoteapi-mcp to npm

License

MIT

Frequently asked questions

What is SOAPNoteAPI?

Generate clinical SOAP notes, billing codes, and visit summaries from transcripts or audio.

How do I install SOAPNoteAPI?

It runs on your machine. In Claude Code: claude mcp add soapnoteapi -e 'SOAPNOTEAPI_KEY=<your soapnoteapi_key>' -- npx -y soapnoteapi-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does SOAPNoteAPI need an API key?

Yes. It expects SOAPNOTEAPI_KEY, which you set in its configuration.

Is SOAPNoteAPI open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains SOAPNoteAPI?

It is published by soapnoteaicom. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.