# UseJunior/safe-docx [Health: Active]

**Category:** 📂 File Systems  
**Repository:** https://github.com/UseJunior/safe-docx  
**GitHub Stars:** 41  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/usejunior-safe-docx

## Description
Surgical editing of existing Word .docx files with formatting preservation, tracked changes, comments, footnotes, and document comparison.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "safe-docx": {
    "command": "npx",
    "args": ["-y","usejunior-safe-docx"]
  }
}
```

## Documentation & README

# Safe Docx

Edit Word and OpenDocument files with coding agents.

<!-- SYNC:badges BEGIN -->
[![CI](https://github.com/usejunior/safe-docx/actions/workflows/ci.yml/badge.svg)](https://github.com/usejunior/safe-docx/actions/workflows/ci.yml)
[![codecov](https://img.shields.io/codecov/c/github/usejunior/safe-docx/main)](https://app.codecov.io/gh/usejunior/safe-docx)
[![npm version](https://img.shields.io/npm/v/@usejunior/safe-docx)](https://www.npmjs.com/package/@usejunior/safe-docx)
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache--2.0-green.svg)](https://github.com/UseJunior/safe-docx/blob/main/LICENSE)
[![GitHub last commit](https://img.shields.io/github/last-commit/UseJunior/safe-docx)](https://github.com/UseJunior/safe-docx/commits/main)
[![GitHub issues closed](https://img.shields.io/github/issues-closed/UseJunior/safe-docx)](https://github.com/UseJunior/safe-docx/issues?q=is%3Aissue+is%3Aclosed)
<!-- SYNC:badges END -->

<!-- SYNC:lang-nav BEGIN -->
[English](https://github.com/UseJunior/safe-docx/blob/HEAD/README.md) · [Español](https://github.com/UseJunior/safe-docx/blob/HEAD/README.es.md) · [简体中文](https://github.com/UseJunior/safe-docx/blob/HEAD/README.zh.md) · [Português](https://github.com/UseJunior/safe-docx/blob/HEAD/README.pt-br.md) · [Deutsch](https://github.com/UseJunior/safe-docx/blob/HEAD/README.de.md)
<!-- SYNC:lang-nav END -->

Safe Docx is a local MCP server and CLI for reading, searching, editing, comparing, converting, and saving document files. It preserves DOCX structure and can produce clean or tracked-changes output.

## Example

Ask your coding agent:

```text
Edit NDA.docx. Change the governing law from New York to Delaware.
Save a clean copy and a tracked-changes copy. Do not change anything else.
```

Safe Docx finds the clause, applies the targeted edit, and writes both files for review. The rest of the document stays outside the requested edit.

Follow the complete [editing walkthrough](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/tutorial.md).

## Comparisons

- [SuperDoc](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/comparisons.md#superdoc)
- [Claude's built-in DOCX editing](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/comparisons.md#claudes-built-in-docx-editing)
- [python-docx](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/comparisons.md#python-docx)
- [DOCX compatibility matrix](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/comparisons.md#compatibility-matrix)

## Install

```bash
npm install --global @usejunior/safe-docx
```

Then configure your MCP client with the installed executable's absolute path. For Claude Code:

```bash
claude mcp add safe-docx -- /absolute/path/to/safe-docx
```

### Antigravity CLI

Add Safe Docx to `~/.gemini/config/mcp_config.json`:

```json
{
  "mcpServers": {
    "safe-docx": {
      "command": "/absolute/path/to/safe-docx",
      "args": []
    }
  }
}
```

Restart `agy`, then ask it to edit a `.docx` file. Antigravity may ask you to approve the MCP server before first use.

See [Installation and verification](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/installation.md) for locating the executable, pinning a version, and configuring clients.

## Documentation

- [Installation and verification](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/installation.md)
- [Tool reference](https://github.com/UseJunior/safe-docx/blob/HEAD/packages/docx-mcp/docs/tool-reference.generated.md)
- [TypeScript library](https://github.com/UseJunior/safe-docx/blob/HEAD/packages/docx-core/README.md)
- [Architecture](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/architecture.md)
- [Testing and evidence](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/testing-and-evidence.md)
- [Trust and conformance](https://github.com/UseJunior/safe-docx/blob/HEAD/docs/trust-and-conformance.md)
- [Contributing](https://github.com/UseJunior/safe-docx/blob/HEAD/CONTRIBUTING.md)

## Standards Conformance

Browse the [Safe Docx Conformance Explorer](https://usejunior.com/engineering/safe-docx/conformance) to navigate ECMA-376 sections, OOXML schema declarations, capability claims, explicit non-goals, and measured cross-implementation outcomes.

The generated [repository conformance report](https://github.com/UseJunior/safe-docx/blob/HEAD/spec-compliance/CONFORMANCE.md) remains the source-controlled record of targeted sections, non-goals, and verification references.

## What Safe Docx Is Not Optimized For

Safe Docx is not a visual editor or layout engine. It does not provide browser rendering, real-time collaboration, or pixel-level pagination guarantees. `.dotx` templates must be converted to `.docx` before use.