Safe Docx is a local MCP server and command-line tool (CLI), primarily aimed at scenarios where coding agents edit Word and OpenDocument files. It is composed of components such as docx-primitives, docx-comparison, and the safe-docx MCP server.
In terms of purpose, Safe Docx is used to read, search, edit, compare, convert, and save document files. It emphasizes preserving DOCX structure during editing and can output either a clean version or a version with tracked changes for review. A typical usage is to have a coding agent locate a clause, perform a targeted edit, and write out two files for review at the same time, while the rest of the document remains outside the scope of the requested edit.
Main capabilities include: reading, searching, editing, comparing, converting, and saving documents; preserving DOCX structure; generating clean or tracked-changes output; and supporting document comparison. The repository also provides a complete editing operations walkthrough, a DOCX compatibility matrix, installation and verification instructions, a TypeScript library, tests and evidence, Trust and conformance, Standards Conformance, and more. It also provides the Safe Docx Conformance Explorer for browsing ECMA-376 sections, OOXML schema declarations, capability declarations, explicit non-goals, and cross-implementation measurement results; the generated repository conformance report is a version-controlled record containing target sections, non-goals, and verification references.
In terms of usage, Safe Docx runs as a local MCP server and CLI. It must first be installed, and then the MCP client must be configured using the absolute path of the installed executable. The documentation provides a configuration example for Claude Code, as well as the configuration method for the Antigravity CLI: add Safe Docx to ~/.gemini/config/mcp_config.json, restart agy, and then you can ask it to edit .docx files; Antigravity may require approval of the MCP server before first use. The installation and verification section explains how to locate the executable, pin the version, and configure the client.
Applicable scenarios are mainlyto let coding agents make structured, reviewable edits to Word documents, such as finding and modifying specific clauses while preserving document elements such as formatting, revisions, comments, and footnotes, and supporting document comparison.
In terms of limitations, Safe Docx is not a visual editor or layout engine, and does not provide browser rendering, real-time collaboration, or pixel-level pagination guarantees. .dotx templates must first be converted to .docx before use. The repository also lists an explanation of "what scenarios Safe Docx is not optimized for."
Other information: the repository includes a Code of conduct and a Security policy. The documentation is available in English, Spanish, Simplified Chinese, Portuguese, and German versions.
