safe-docx is a TypeScript-based MCP server for surgically editing, comparing, and analyzing existing Microsoft Word .docx files and Google Docs in agent workflows, with a focus on formatting preservation and deterministic edits.

Reading & Searching

• read_file – Read document content in various formats (toon, json, simple) with pagination

• grep – Search paragraphs using regex across one or multiple files, with optional XML-level search

• get_file_status – Retrieve file/session metadata (edit count, normalization stats, cache info)

Editing

• replace_text – Replace text within a paragraph by ID, preserving formatting

• insert_paragraph – Insert a new paragraph before/after an anchor, with optional style cloning

• format_layout – Apply paragraph spacing, table row height, and cell padding controls

• clear_formatting – Remove specific run-level formatting (bold, italic, underline, highlight, color, font)

Batch & Multi-Agent Planning

• init_plan – Initialize revision-bound context for coordinated multi-agent planning

• merge_plans – Deterministically merge sub-agent plans and detect conflicts before applying

• apply_plan – Validate and apply a batch of edit steps atomically

Saving & Comparing

• save – Save as clean output, tracked-changes output, or both; supports Google Docs checkpointing

• compare_documents – Compare two DOCX files and produce a tracked-changes output document

Tracked Changes

• has_tracked_changes – Check whether a document contains tracked-change markers

• accept_changes – Accept all tracked changes to produce a clean document

• extract_revisions – Extract tracked changes as structured JSON with before/after text and comments (paginated)

Comments

• add_comment / get_comments / delete_comment – Add, retrieve, and delete comments and threaded replies anchored to paragraphs or specific text

Footnotes

• add_footnote / get_footnotes / update_footnote / delete_footnote – Full CRUD for footnotes anchored to paragraphs

Session Management

• close_file – Close an open file session or clear all sessions

The server runs entirely locally with no external server dependencies, supporting both DOCX files and Google Docs integration.

Allows editing of Google Docs documents alongside DOCX files, supporting operations such as reading, searching, replacing text, inserting paragraphs, adding comments and footnotes, and applying layout formatting controls to documents stored in Google Drive.