Word AI — Claude Code MCP server: what it does, how to install
Modifies Word DOCX files with atomic patches while preserving styles, tables, and numbering intact. Useful for safe agentic document updates without markup distortion.
Open on GitHubWhat Word AI does
Exporting Word files to Markdown and back routinely damages numbering, nested tables, and styles. Word AI keeps the original DOCX layout intact. Instead of rewriting entire archives, the agent dispatches targeted PatchSet instructions. The system verifies SHA-256 hashes before altering any XML node.
The server includes 63 MCP tools covering comments, tracked changes, bookmarks, and structural blocks. Offline processing runs on a .NET 8 Open XML backend wrapped by a Python interface. For documents open on the desktop, an Office.js taskpane communicates with a local HTTP bridge.
Compiling the transaction engine locally demands .NET SDK 8. Ready-made standalone release bundles bypass this requirement entirely. Direct file overwriting without dry runs and diff generation is blocked by default.
What it helps with
- update DOCX files without breaking layout and typography
- verify text hashes prior to applying document edits
- control active Microsoft Word sessions via Office.js
- roll back failed patches using audit logs and diffs
Example prompts for the agent
- Update the overview section inside
spec.docxafter confirming text hashes. - Inspect table structures in the active Word session and generate a
PatchSet. - Run a dry-run patch for the
WORD-AI:SRS:1.0:overviewtag incontract.docx.
How to install Word AI
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Word AI
How to install Word AI for Claude Code?
Clone the project repository with git clone https://github.com/flyfish-dev/word-ai.git, enter the directory, and run bash scripts/install.sh. The installer configures the dependencies and adds the word-ai skill to Claude Code. Alternatively, unpack a standalone release archive and run ./word-ai install-skill.
What does Word AI do?
It equips AI agents with 63 MCP tools to inspect and selectively edit DOCX files. Updates execute via constrained PatchSet operations backed by hash verification and Open XML validation.
Is .NET SDK required to run the server?
Compiling the offline Open XML engine from source requires .NET SDK 8. Downloading the prebuilt standalone release bundles eliminates the need for a local .NET installation.
