redacta-mcp — Claude Code MCP server: what it does, install
Redacts patient identifiers locally before an AI agent processes a clinical document. Useful when raw medical details must stay on the machine.
claude mcp add redacta-mcp -- npx -y redacta-mcpWhat redacta-mcp does
redacta-mcp pseudonymises clinical and medical documents before they reach an AI tool. It turns patient names, birth dates, contact details and other identifiers into labelled tokens, then returns a report describing the changes. A local token map can later restore the original values.
The MCP server uses a shared TypeScript detection engine with fixed-format matching. Agent reasoning handles free-form names, relatives, addresses and ages, followed by a pass that checks for identifiers missed earlier. HIPAA Safe Harbor mode adds stricter handling for dates, ages and further healthcare identifiers. For clinical data, the boundary is concrete: raw identifiers remain on the local machine while the AI receives tokenised text.
What it helps with
- redact patient identifiers from a clinical file
- prepare medical text for AI processing
- restore original values after agent work
- scan output for identifiers that slipped through
- apply HIPAA Safe Harbor handling
Example prompts for the agent
- Redact patient identifiers in
case-notes.txtbefore sending the document to another AI tool. - Process this clinical note, return the redaction report, and restore the original values locally afterward.
- Use HIPAA Safe Harbor mode on this document and remove the additional identifiers it covers.
How to install redacta-mcp
Platform CLI
claude mcp add redacta-mcp -- npx -y redacta-mcpPlatform CLI
codex mcp add redacta-mcp -- npx -y redacta-mcpConfig file
{
"mcpServers": {
"redacta-mcp": {
"command": "npx",
"args": [
"-y",
"redacta-mcp"
]
}
}
}Config file
{
"servers": {
"redacta-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"redacta-mcp"
]
}
}
}Platform CLI
gemini mcp add redacta-mcp npx -y redacta-mcpStep 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 redacta-mcp
How do I install redacta-mcp in Claude Code?
Run claude mcp add redacta-mcp -- npx -y redacta-mcp.
What does redacta-mcp do?
It replaces patient identifiers in medical documents with labelled tokens, produces a redaction report, and can restore the original values from a local token map.
Which identifiers can it detect?
The pattern layer covers UK medical and insurance numbers, birth dates, postcodes, phones, email addresses, hospital numbers, plus US SSNs and ZIP codes. Agent reasoning adds names, relatives, addresses and ages.
