English Français العربية

SOAPNoteAPI

Registre officiel Santé

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que SOAPNoteAPI ?

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

Comment installer SOAPNoteAPI ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add soapnoteapi -e 'SOAPNOTEAPI_KEY=<your soapnoteapi_key>' -- npx -y soapnoteapi-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour SOAPNoteAPI ?

Oui. Il attend SOAPNOTEAPI_KEY, à renseigner dans sa configuration.

SOAPNoteAPI est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient SOAPNoteAPI ?

Il est publié par soapnoteaicom. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.