The only MCP server that edits Word documents while they're open Live editing · Tracked changes · Per-action undo · 114 tools · Cross-platform word-mcp-live gives any AI assistant that supports MCP full control of Microsoft Word. Open a document, tell the AI what you need, and watch it happen — formatting, tracked changes, comments, and all. Changes appear live in your
Add this skill
npx mdskills install ykarapazar/word-mcp-liveComprehensive MCP server offering 114 tools for Word document control with live editing and tracked changes
1<div align="center">23[](https://cursor.com/en/install-mcp?name=word&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ3b3JkLW1jcC1saXZlIl19)45# word-mcp-live67**The only MCP server that edits Word documents while they're open**89`Live editing` · `Tracked changes` · `Per-action undo` · `114 tools` · `Cross-platform`1011[](https://pypi.org/project/word-mcp-live/)12[](https://www.python.org/downloads/)13[](LICENSE)14[]()1516</div>1718---1920word-mcp-live gives any AI assistant that supports [MCP](https://modelcontextprotocol.io/) full control of Microsoft Word. Open a document, tell the AI what you need, and watch it happen — formatting, tracked changes, comments, and all. Changes appear live in your open document.2122<table>23<tr>24<td width="50%">2526### Without word-mcp-live2728- AI can discuss your document but can't touch it29- You copy-paste between AI and Word, losing formatting30- Track changes? You do those manually after the fact31- Every edit means save → close → process → reopen3233</td>34<td width="50%">3536### With word-mcp-live3738- "Add a tracked change replacing ABC Corp with XYZ Ltd" — done39- Changes appear live in your open Word document40- Every AI edit is one Ctrl+Z away41- Real tracked changes with your name, not XML hacks4243</td>44</tr>45</table>4647### See it in action4849https://github.com/user-attachments/assets/fbb09af4-1e25-4e49-94d0-45b3632788105051## What Sets This Apart5253- **Live editing** — Edit documents while they're open in Word. No save-close-reopen cycle.54- **Full undo** — Every AI action is a single Ctrl+Z. Made a mistake? Just undo it.55- **Native tracked changes** — Real Word revisions with your name, not XML hacks.56- **Threaded comments** — Add, reply, resolve, and delete comments like a human reviewer.57- **Layout diagnostics** — Detects formatting problems before they become print disasters.58- **Equations & cross-references** — Insert math formulas and auto-updating references.59- **114 tools** — The most comprehensive Word MCP server available.6061## Quick Start6263```bash64pip install word-mcp-live65```6667Or install from source:6869```bash70git clone https://github.com/ykarapazar/word-mcp-live.git71cd word-mcp-live72pip install -e .73```7475## Client Installation7677<details open>78<summary><b>Claude Desktop</b></summary>7980Add to your `claude_desktop_config.json`:8182```json83{84 "mcpServers": {85 "word": {86 "command": "uvx",87 "args": ["word-mcp-live"],88 "env": {89 "MCP_AUTHOR": "Your Name",90 "MCP_AUTHOR_INITIALS": "YN"91 }92 }93 }94}95```9697</details>9899<details>100<summary><b>Claude Code</b></summary>101102Add to your `.mcp.json`:103104```json105{106 "mcpServers": {107 "word": {108 "command": "uvx",109 "args": ["word-mcp-live"],110 "env": {111 "MCP_AUTHOR": "Your Name",112 "MCP_AUTHOR_INITIALS": "YN"113 }114 }115 }116}117```118119</details>120121<details>122<summary><b>Cursor</b></summary>123124**One-click:** Click the install button at the top of this page.125126**Manual:** Add to `~/.cursor/mcp.json`:127128```json129{130 "mcpServers": {131 "word": {132 "command": "uvx",133 "args": ["word-mcp-live"],134 "env": {135 "MCP_AUTHOR": "Your Name",136 "MCP_AUTHOR_INITIALS": "YN"137 }138 }139 }140}141```142143</details>144145<details>146<summary><b>VS Code / Copilot</b></summary>147148**One-click:** [Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%20%22word%22%2C%20%22command%22%3A%20%22uvx%22%2C%20%22args%22%3A%20%5B%22word-mcp-live%22%5D%7D)149150**Manual:** Add to your VS Code `settings.json`:151152```json153{154 "mcp": {155 "servers": {156 "word": {157 "command": "uvx",158 "args": ["word-mcp-live"],159 "env": {160 "MCP_AUTHOR": "Your Name",161 "MCP_AUTHOR_INITIALS": "YN"162 }163 }164 }165 }166}167```168169</details>170171<details>172<summary><b>Windsurf</b></summary>173174Add to `~/.codeium/windsurf/mcp_config.json`:175176```json177{178 "mcpServers": {179 "word": {180 "command": "uvx",181 "args": ["word-mcp-live"],182 "env": {183 "MCP_AUTHOR": "Your Name",184 "MCP_AUTHOR_INITIALS": "YN"185 }186 }187 }188}189```190191</details>192193<details>194<summary><b>Docker</b></summary>195196```json197{198 "mcpServers": {199 "word": {200 "command": "docker",201 "args": ["run", "-i", "--rm", "ghcr.io/ykarapazar/word-mcp-live"],202 "env": {203 "MCP_AUTHOR": "Your Name",204 "MCP_AUTHOR_INITIALS": "YN"205 }206 }207 }208}209```210211> Note: Docker mode supports cross-platform tools only. Live editing requires a native Windows install.212213</details>214215> **`MCP_AUTHOR`** sets your name on tracked changes and comments (default: `"Author"`). **`MCP_AUTHOR_INITIALS`** sets comment initials.216217## Two Modes218219| | Works everywhere | Windows with Word open |220|---|---|---|221| **What it does** | Create and edit saved .docx files | Edit documents live while you work in Word |222| **Platform** | Windows, macOS, Linux | Windows only |223| **Undo** | File-level saves | Per-action Ctrl+Z |224| **Best for** | Batch processing, document generation | Interactive editing, formatting, review |225226Both modes work together. The AI picks the right one for the task.227228## Configuration229230| Variable | Default | Description |231|----------|---------|-------------|232| `MCP_AUTHOR` | `"Author"` | Author name for tracked changes and comments |233| `MCP_AUTHOR_INITIALS` | `""` | Author initials for comments |234| `MCP_TRANSPORT` | `stdio` | Transport type: `stdio`, `sse`, or `streamable-http` |235| `MCP_HOST` | `0.0.0.0` | Host to bind (for SSE/HTTP transports) |236| `MCP_PORT` | `8000` | Port to bind (for SSE/HTTP transports) |237238For remote deployment, see [RENDER_DEPLOYMENT.md](RENDER_DEPLOYMENT.md).239240## Example Prompts241242Just tell the AI what you want in plain language:243244```245"Draft a contract with tracked changes so my colleague can review"246"Format all headings as Cambria 13pt bold and add automatic numbering"247"Add a comment on paragraph 3 asking about the deadline"248"Find every mention of 'ABC Corp' and replace with 'XYZ Ltd' as a tracked change"249"Set the page to A4 landscape with 2cm margins"250"Insert a table of contents based on the document headings"251"Add page numbers in the footer and our company name in the header"252"Insert a cross-reference to Heading 2 in paragraph 5"253```254255## Usage Examples256257### Example 1: Read a document (cross-platform)258259**Tool call:** `get_document_text`260```json261{ "filename": "C:/Documents/report.docx" }262```263**Expected output:**264```json265{266 "status": "success",267 "paragraphs": [268 {"index": 0, "text": "Quarterly Report", "style": "Heading 1"},269 {"index": 1, "text": "Revenue increased by 15% compared to Q3.", "style": "Normal"},270 {"index": 2, "text": "Key Metrics", "style": "Heading 2"}271 ],272 "total_paragraphs": 3273}274```275276### Example 2: Live editing with tracked changes (Windows)277278**Tool call:** `word_live_replace_text`279```json280{281 "filename": "report.docx",282 "find_text": "ABC Corporation",283 "replace_text": "XYZ Ltd",284 "match_case": true,285 "replace_all": true,286 "track_changes": true287}288```289**Expected output:**290```json291{292 "status": "success",293 "replacements": 4,294 "message": "Replaced 4 occurrences (tracked changes enabled)"295}296```297The replacements appear as tracked changes in Word with strikethrough on "ABC Corporation" and underline on "XYZ Ltd".298299### Example 3: Add a comment anchored to text (cross-platform)300301**Tool call:** `add_comment`302```json303{304 "filename": "C:/Documents/contract.docx",305 "target_text": "payment within 30 days",306 "comment_text": "Should we extend this to 45 days?",307 "author": "Jane Smith"308}309```310**Expected output:**311```json312{313 "status": "success",314 "message": "Comment added by Jane Smith on 'payment within 30 days'"315}316```317The comment appears in Word's Review panel, anchored to the specified text.318319## Tool Reference320321**114 tools** across two modes — see the [complete tool reference](TOOLS.md) for details.322323| Category | Count |324|----------|-------|325| Cross-platform (python-docx) | 75 |326| Windows Live (COM automation) | 39 |327328## Requirements329330- **Python 3.11+**331- `python-docx`, `fastmcp`, `msoffcrypto-tool` (installed automatically)332- **Windows Live tools only:** Windows 10/11 + Microsoft Word + `pywin32`333334> The cross-platform tools work without Word installed — only python-docx is needed.335336## Contributing337338See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, code style, and how to add new tools.339340Found a bug? [Open an issue](https://github.com/ykarapazar/word-mcp-live/issues/new?template=bug_report.md).341Have an idea? [Request a feature](https://github.com/ykarapazar/word-mcp-live/issues/new?template=feature_request.md).342343## Acknowledgments344345Built on top of [GongRzhe/Office-Word-MCP-Server](https://github.com/GongRzhe/Office-Word-MCP-Server) by GongRzhe (MIT License).346347Additional libraries: [python-docx](https://python-docx.readthedocs.io/) · [FastMCP](https://github.com/modelcontextprotocol/python-sdk) · [pywin32](https://github.com/mhammond/pywin32)348349## Privacy350351This server runs entirely on your local machine. No data is collected, transmitted, or stored. See the full [Privacy Policy](PRIVACY.md).352353## Support354355- **Bug reports:** [Open an issue](https://github.com/ykarapazar/word-mcp-live/issues/new?template=bug_report.md)356- **Feature requests:** [Request a feature](https://github.com/ykarapazar/word-mcp-live/issues/new?template=feature_request.md)357- **Discussions:** [GitHub Discussions](https://github.com/ykarapazar/word-mcp-live/discussions)358359## License360361MIT License — see [LICENSE](LICENSE) for details.362363## Star History364365<a href="https://star-history.com/#ykarapazar/word-mcp-live&Date">366 <picture>367 <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ykarapazar/word-mcp-live&type=Date&theme=dark" />368 <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ykarapazar/word-mcp-live&type=Date" />369 <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=ykarapazar/word-mcp-live&type=Date" />370 </picture>371</a>372373<!-- mcp-name: io.github.ykarapazar/word-mcp-live -->374
Full transparency — inspect the skill content before installing.