How do I install SOAPNoteAPI?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does SOAPNoteAPI need an API key?

The publisher lists these environment variables: SOAPNOTEAPI_KEY.

What transport does SOAPNoteAPI use?

SOAPNoteAPI runs locally over stdio.

When was SOAPNoteAPI last checked?

Last checked 2026-11-08. Generate clinical SOAP notes, billing codes, and visit summaries from transcripts or audio.

SOAPNoteAPI MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

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

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1SOAPNOTEAPI_KEY=<secret> claude mcp add com.soapnoteapi-soapnoteapi-mcp -- npx -y soapnoteapi-mcp@0.1.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.soapnoteapi-soapnoteapi-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "SOAPNOTEAPI_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.1
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

Tool	What it does	API
`list_specialties`	List supported specialties (no key needed)	`GET /v1/specialties`
`generate_soap_note`	Transcript → SOAP note (+ optional billing codes, patient summary)	`POST /v1/note`
`get_note`	Fetch a note by `noteId`	`GET /v1/note/{id}`
`summarize_visits`	Consolidate visits into a longitudinal summary	`POST /v1/visit-summary`
`transcribe_audio_to_soap`	Local audio file → SOAP note (waits for async jobs)	`PUT /v1/note/audio`
`get_audio_status`	Poll an async audio job	`GET /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

Variable	Required	Notes
`SOAPNOTEAPI_KEY`	yes (for all tools except `list_specialties`)	Bearer key, `snapi_sk_live_…` or `snapi_sk_test_…`
`SOAPNOTEAPI_BASE_URL`	no	Override 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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install SOAPNoteAPI?

Does SOAPNoteAPI need an API key?

What transport does SOAPNoteAPI use?

When was SOAPNoteAPI last checked?

Documentation

soapnoteapi-mcp

Tools

Setup

Claude Desktop / Cursor (mcp.json)

Claude Code

Environment variables

Develop

Publish

License

Claude Desktop / Cursor (`mcp.json`)