Skip to main content
MCP server CX Codex

DICOMweb MCP Server — Claude Code MCP server

DICOMweb MCP Server is a Claude Code MCP server that connects an AI assistant to a DICOMweb archive. It searches imaging records and reads reports on request.

MIT ★ 5 updated 2026-10-19

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env DICOMWEB_HOST=<DICOMWEB_HOST> --env DICOMWEB_AUTH=<DICOMWEB_AUTH> --env DICOMWEB_USER=<DICOMWEB_USER> --env DICOMWEB_PASS=<DICOMWEB_PASS> --env DICOMWEB_TOKEN=<DICOMWEB_TOKEN> --transport stdio dicomweb-mcp-server -- npx -y dicomweb-mcp-server
Open on GitHub

What DICOMweb MCP Server does

The server connects an AI assistant to a DICOM archive through QIDO-RS and WADO-RS. It searches studies, series, and instances, retrieves metadata, extracts text from structured reports and PDFs, and renders image frames.

It requires Node.js 20 or later and a running DICOMweb server that supports QIDO-RS and WADO-RS. Set the archive address with DICOMWEB_HOST; authentication can use DICOMWEB_AUTH and the matching credentials. Text extraction works on PDFs with an embedded text layer. Scanned page images are not processed with OCR.

What it helps with

  • search DICOM studies using filters
  • retrieve series and instances from a study
  • extract readable text from structured reports
  • read a text-based PDF report in the archive
  • render a DICOM image frame

Example prompts for the agent

  • Find CT studies for patient John Doe.
  • Find every PDF report in study 1.2.3.4.
  • Read the report for SOP instance 1.2.3.4.5.

How to install DICOMweb MCP Server

Platform CLI

claude mcp add --env DICOMWEB_HOST=<DICOMWEB_HOST> --env DICOMWEB_AUTH=<DICOMWEB_AUTH> --env DICOMWEB_USER=<DICOMWEB_USER> --env DICOMWEB_PASS=<DICOMWEB_PASS> --env DICOMWEB_TOKEN=<DICOMWEB_TOKEN> --transport stdio dicomweb-mcp-server -- npx -y dicomweb-mcp-server

Replace <…> with your own values. 1 more environment variable is in the server README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about DICOMweb MCP Server

How do I install DICOMweb MCP Server in Claude Code?

Run `claude mcp add dicomweb-mcp-server -e DICOMWEB_HOST=<DICOMWEB_HOST> -e DICOMWEB_PASS=<DICOMWEB_PASS> -e DICOMWEB_TOKEN=<DICOMWEB_TOKEN> -- npx -y dicomweb-mcp-server. Set DICOMWEB_HOST` to the DICOMweb server address.

What does DICOMweb MCP Server do?

It connects an AI assistant to a DICOMweb archive. The server can search studies, series, and instances, retrieve metadata, and read report text.

What does DICOMweb MCP Server need to run?

It requires Node.js 20 or later and a running DICOMweb server with QIDO-RS and WADO-RS support. Set DICOMWEB_HOST; configure DICOMWEB_AUTH and the corresponding credentials if authentication is used.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open