← Back to directory
S

Safe Docx MCP Server

Community
AI-native surgical editing of Word and OpenDocument files with formatting preservation
Category
Filesystem #3 of 24
Stars
★ 46 Popular
Transport
stdio (local process)
Runtime
Node.js
Credentials
No credential needed
License
Apache-2.0
Last commit
68FMRS · C

Safe Docx is a local, stdio-based MCP server (npm-distributed, Apache-2.0) built for coding agents, offering surgical, format-preserving edits to .docx/.odt files with conformance evidence for OOXML compatibility. It is not suited as a visual editor or collaboration tool.

Strongest · Documentation 18/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
16/20
Maintenance
14/20
Documentation
18/20
Setup experience
12/20
Why each score
Reliability 8/20
The project has CI workflows and codecov coverage reports, indicating basic test coverage. The server manifest provides version information and architecture description, but actual tool implementation and error handling cannot be verified through static analysis alone. The score is conservative as full functionality implementation cannot be confirmed.
Security and permissions 16/20
The project uses Apache 2.0 license with clear permission boundaries. No credential handling issues or dangerous operation defaults are apparent. Documentation specifies local processing without external network calls, establishing clear data boundaries. No obvious security risks were identified.
Maintenance 14/20
The project has regular CI builds and version releases with active issue tracking on GitHub. Dependencies are clearly managed, with an Apache 2.0 license and security response channels. While there are many open issues (52), most are likely closed or actively being addressed.
Documentation 18/20
Comprehensive installation guides, tool references, and architecture documentation are provided. Multi-language support including Chinese is available. Documentation includes limitations and compatibility information, with complete tutorials and comparison guides. The documentation is well-structured and covers use cases and constraints.
Setup experience 12/20
Installation steps are clearly documented via npm global install with MCP client configuration examples provided. However, users must manually find the absolute path to the executable, which may be challenging for some users. No automated installation scripts are provided, requiring manual configuration.

Static review · not runListed 2026-09-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local files

Best for

  • Developers who need precise, format-preserving edits to .docx/.odt files via coding agents
  • Workflows that require tracked-changes output for human review

Not for

  • Visual editing scenarios needing browser rendering, real-time collaboration, or pixel-level pagination guarantees
  • Using .dotx templates directly (they must be converted to .docx first)

Required permissions

  • Filesystem access to read and write local .docx / .odt documents

Risks and side effects

  • Edits apply to local files; incorrect targeted changes could overwrite original content — use the clean/tracked-changes dual output for review
  • The project is not a visual editor or layout engine, so complex layout results should be verified manually

Setup

Before you start

Runtime:Node.js

Install globally with npm install --global @usejunior/safe-docx, then configure your MCP client with the installed executable's absolute path. For Claude Code: claude mcp add safe-docx -- /absolute/path/to/safe-docx.

Check that it works

After installing globally with npm, configure your MCP client with the executable's absolute path (e.g., claude mcp add safe-docx -- /absolute/path/to/safe-docx), then ask the client to read a .docx file; a returned document confirms the connection.

Troubleshooting

  1. Verify the npm package is globally installed and the client uses the executable's absolute path
  2. Ensure .dotx templates were converted to .docx before use
  3. See docs/installation.md in the repository for version pinning and client configuration

Things to try

Once connected, you can ask your AI assistant things like:

  • Edit NDA.docx: change the governing law from New York to Delaware, save a clean copy and a tracked-changes copy, and change nothing else.
  • Search this .docx for every paragraph mentioning 'confidentiality' and tell me where they are.
  • Convert report.docx and save it as a new file with formatting preserved.
  • Compare contract-v1.docx and contract-v2.docx and list the differences.

Use cases

Have a coding agent make targeted edits to a .docx (e.g., change the governing-law clause in an NDA) and save both clean and tracked-changes copies
Search, compare, and convert Word / OpenDocument files

Overview

Safe Docx is a local MCP server and CLI for reading, searching, editing, comparing, converting, and saving .docx and .odt files. Distributed via the npm package @usejunior/safe-docx over stdio, it preserves document structure and can produce clean or tracked-changes output. The project is Apache-2.0 licensed and publishes ECMA-376 / OOXML conformance reports. No tool names are listed in the source material, so the tool list is left empty.

Similar servers

Source revision c4d58c02aa7e Data synced 2026-10-19 Read the FMRS scoring method