Server data from the Official MCP Registry
AI-native surgical editing of existing Word .docx files with formatting preservation
AI-native surgical editing of existing Word .docx files with formatting preservation
Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
12 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-usejunior-safe-docx": {
"args": [
"-y",
"@usejunior/safe-docx"
],
"command": "npx"
}
}
}From the project's GitHub README.
English | Español | 简体中文 | Português (Brasil) | Deutsch
safe-docx by UseJunior — use coding agents for paperwork too.
Part of the UseJunior developer tools.
Safe Docx is an open-source TypeScript stack for surgical editing of existing Microsoft Word .docx files. It is built for workflows where an agent proposes changes and a human still needs reliable, formatting-preserving document edits.
If you review contracts with AI, the slowest step is often applying accepted recommendations in Word. Safe Docx turns that into deterministic tool calls.
AI coding CLIs are great with code and text files but weak on brownfield .docx editing. Business and legal workflows still run on Word documents, so we built a native TypeScript path for:
Mission: enable coding agents to do paperwork too. Safe Docx focuses on deterministic edits to existing Word files where formatting and review semantics must survive automation.
Safe Docx is optimized for agent workflows that need deterministic, local-first edits on existing .docx files:
Safe Docx is not intended to replace generation-first .docx libraries.
npx -y @usejunior/safe-docx
For detailed setup and tool reference, see packages/docx-mcp/README.md.
When you prompt a coding agent (Claude Code, Cursor, Gemini CLI) with Safe Docx installed, the agent makes MCP tool calls like these:
User: Edit the NDA at ~/docs/NDA.docx — change the governing law
from "State of New York" to "State of Delaware" and save both
a clean copy and a tracked-changes copy.
Agent calls:
1. read_file(file_path="~/docs/NDA.docx", format="toon")
→ Returns paragraphs with stable IDs: _bk_1, _bk_2, ...
2. grep(file_path="~/docs/NDA.docx", pattern="State of New York")
→ Match in paragraph _bk_47
3. replace_text(
file_path="~/docs/NDA.docx",
target_paragraph_id="_bk_47",
old_string="State of New York",
new_string="State of Delaware",
instruction="Change governing law to Delaware"
)
4. save(
file_path="~/docs/NDA.docx",
save_to_local_path="~/docs/NDA-clean.docx",
tracked_save_to_local_path="~/docs/NDA-tracked.docx",
save_format="both"
)
The agent handles the tool calls automatically. You get a clean file and a tracked-changes file for human review.
claude mcp add safe-docx -- npx -y @usejunior/safe-docx
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"safe-docx": {
"command": "npx",
"args": ["-y", "@usejunior/safe-docx"]
}
}
}
{
"mcpServers": {
"safe-docx": {
"command": "npx",
"args": ["-y", "@usejunior/safe-docx"]
}
}
}
npx["-y", "@usejunior/safe-docx"].docx filesdownload, compare_documents)extract_revisions)Safe Docx is not a from-scratch document generation toolkit.
If your primary need is generating new .docx files from templates/programmatic layout, use packages such as docx.
The local Safe Docx runtime also intentionally rejects Word template files (.dotx) for now. Convert the template to a normal .docx document before opening it here.
.docx classes@usejunior/docx-core: primitives + comparison engine for existing .docx documents@usejunior/docx-mcp: MCP server implementation and tool surface@usejunior/safe-docx: canonical end-user install name (npx -y @usejunior/safe-docx)@usejunior/safedocx-mcpb: private MCP bundle wrapperpackages/docx-mcp/src/tool_catalog.ts.packages/docx-mcp/src/testing/SAFE_DOCX_OPENSPEC_TRACEABILITY.mdpackages/docx-mcp/assumptions.mddocs/safe-docx/sprint-3-conformance.mdA TypeScript-first DOCX editing stack for coding-agent workflows that need deterministic, formatting-preserving edits on existing Word documents.
That is a core design goal. The tool surface is built around surgical operations (replace_text, insert_paragraph, layout controls) that preserve document structure and formatting semantics as much as possible.
No. Supported runtime usage is JavaScript/TypeScript with jszip + @xmldom/xmldom.
Not the primary focus. For from-scratch generation, use packages such as docx.
Mutual NDAs (including Common Paper/Bonterms-style fixtures), Letter of Intent, and ILPA limited partnership agreement redline fixtures.
No. The same brownfield .docx editing problems appear in HR, procurement, finance, sales ops, and other paperwork-heavy workflows.
Use @usejunior/safe-docx via npx, then follow setup examples in packages/docx-mcp/README.md.
See the generated reference at packages/docx-mcp/docs/tool-reference.generated.md.
npm ci
npm run build
npm run lint --workspaces --if-present
npm run test:run
npm run check:spec-coverage
npm run test:coverage:packages
npm run coverage:packages:check
npm run coverage:matrix
Safe Docx runs entirely on your local machine. No document content is sent to external servers. See our Privacy Policy for details.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.