{
  "markdown": "<div align=\"center\">\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=word&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ3b3JkLW1jcC1saXZlIl19)\n\n# word-mcp-live\n\n**The only MCP server that edits Word documents while they're open**\n\n`Live editing` &middot; `Tracked changes` &middot; `Per-action undo` &middot; `124 tools` &middot; `Cross-platform`\n\n[![PyPI](https://img.shields.io/pypi/v/word-mcp-live?color=blue)](https://pypi.org/project/word-mcp-live/)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n[![Platform: Windows + macOS/Linux](https://img.shields.io/badge/platform-Windows%20%2B%20macOS%2FLinux-lightgrey)]()\n\n</div>\n\n---\n\nword-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.\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### Without word-mcp-live\n\n- AI can discuss your document but can't touch it\n- You copy-paste between AI and Word, losing formatting\n- Track changes? You do those manually after the fact\n- Every edit means save → close → process → reopen\n\n</td>\n<td width=\"50%\">\n\n### With word-mcp-live\n\n- \"Add a tracked change replacing ABC Corp with XYZ Ltd\" — done\n- Changes appear live in your open Word document\n- Every AI edit is one Ctrl+Z away\n- Real tracked changes with your name, not XML hacks\n\n</td>\n</tr>\n</table>\n\n### See it in action\n\nhttps://github.com/user-attachments/assets/fbb09af4-1e25-4e49-94d0-45b363278810\n\n## What Sets This Apart\n\n- **Live editing** — Edit documents while they're open in Word. No save-close-reopen cycle.\n- **Full undo** — Every AI action is a single Ctrl+Z. Made a mistake? Just undo it.\n- **Native tracked changes** — Real Word revisions with your name, not XML hacks.\n- **Threaded comments** — Add, reply, resolve, and delete comments like a human reviewer.\n- **Layout diagnostics** — Detects formatting problems before they become print disasters.\n- **Equations & cross-references** — Insert math formulas and auto-updating references.\n- **124 tools** — The most comprehensive Word MCP server available.\n\n## Quick Start\n\n```bash\npip install word-mcp-live\n```\n\nOr install from source:\n\n```bash\ngit clone https://github.com/ykarapazar/word-mcp-live.git\ncd word-mcp-live\npip install -e .\n```\n\n## Client Installation\n\n<details open>\n<summary><b>Claude Desktop</b></summary>\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"word\": {\n      \"command\": \"uvx\",\n      \"args\": [\"word-mcp-live\"],\n      \"env\": {\n        \"MCP_AUTHOR\": \"Your Name\",\n        \"MCP_AUTHOR_INITIALS\": \"YN\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Claude Code</b></summary>\n\nAdd to your `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"word\": {\n      \"command\": \"uvx\",\n      \"args\": [\"word-mcp-live\"],\n      \"env\": {\n        \"MCP_AUTHOR\": \"Your Name\",\n        \"MCP_AUTHOR_INITIALS\": \"YN\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Cursor</b></summary>\n\n**One-click:** Click the install button at the top of this page.\n\n**Manual:** Add to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"word\": {\n      \"command\": \"uvx\",\n      \"args\": [\"word-mcp-live\"],\n      \"env\": {\n        \"MCP_AUTHOR\": \"Your Name\",\n        \"MCP_AUTHOR_INITIALS\": \"YN\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>VS Code / Copilot</b></summary>\n\n**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)\n\n**Manual:** Add to your VS Code `settings.json`:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"word\": {\n        \"command\": \"uvx\",\n        \"args\": [\"word-mcp-live\"],\n        \"env\": {\n          \"MCP_AUTHOR\": \"Your Name\",\n          \"MCP_AUTHOR_INITIALS\": \"YN\"\n        }\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Windsurf</b></summary>\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"word\": {\n      \"command\": \"uvx\",\n      \"args\": [\"word-mcp-live\"],\n      \"env\": {\n        \"MCP_AUTHOR\": \"Your Name\",\n        \"MCP_AUTHOR_INITIALS\": \"YN\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Docker</b></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"word\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"ghcr.io/ykarapazar/word-mcp-live\"],\n      \"env\": {\n        \"MCP_AUTHOR\": \"Your Name\",\n        \"MCP_AUTHOR_INITIALS\": \"YN\"\n      }\n    }\n  }\n}\n```\n\n> Note: Docker mode supports cross-platform tools only. Live editing requires a native Windows install.\n\n</details>\n\n> **`MCP_AUTHOR`** sets your name on tracked changes and comments (default: `\"Author\"`). **`MCP_AUTHOR_INITIALS`** sets comment initials.\n\n## Two Modes\n\n|  | Works everywhere | Live editing (Word open) |\n|---|---|---|\n| **What it does** | Create and edit saved .docx files | Edit documents live while you work in Word |\n| **Platform** | Windows, macOS, Linux | Windows (COM) and macOS (JXA) |\n| **Undo** | File-level saves | Per-action Ctrl+Z (Windows); per-operation undo (macOS) |\n| **Best for** | Batch processing, document generation | Interactive editing, formatting, review |\n\nBoth modes work together. The AI picks the right one for the task.\n\n### macOS Live Editing (New in v1.5.0)\n\nLive tools now work on macOS via JavaScript for Automation (JXA). Same tool names, same parameters — the server detects your platform and uses the right automation backend.\n\n| Feature | Windows | macOS |\n|---------|---------|-------|\n| Text read/write/find/replace | COM | JXA |\n| Formatting (bold, font, style) | COM | JXA |\n| Track changes & revisions | COM | JXA |\n| Comments (add, delete, list) | COM | JXA |\n| Tables (read, write, add rows) | COM | JXA |\n| Page layout, headers, bookmarks | COM | JXA |\n| Equations, cross-references | COM | JXA |\n| Threaded comment replies | COM | Not available |\n| Comment resolve/unresolve | COM | Not available |\n| Undo history inspection | COM | Not available |\n| Watermarks | COM | Not available |\n\n## Configuration\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `MCP_AUTHOR` | `\"Author\"` | Author name for tracked changes and comments |\n| `MCP_AUTHOR_INITIALS` | `\"\"` | Author initials for comments |\n| `MCP_TRANSPORT` | `stdio` | Transport type: `stdio`, `sse`, or `streamable-http` |\n| `MCP_HOST` | `0.0.0.0` | Host to bind (for SSE/HTTP transports) |\n| `MCP_PORT` | `8000` | Port to bind (for SSE/HTTP transports) |\n\nFor remote deployment, see [RENDER_DEPLOYMENT.md](RENDER_DEPLOYMENT.md).\n\n## Example Prompts\n\nJust tell the AI what you want in plain language:\n\n```\n\"Draft a contract with tracked changes so my colleague can review\"\n\"Format all headings as Cambria 13pt bold and add automatic numbering\"\n\"Add a comment on paragraph 3 asking about the deadline\"\n\"Find every mention of 'ABC Corp' and replace with 'XYZ Ltd' as a tracked change\"\n\"Set the page to A4 landscape with 2cm margins\"\n\"Insert a table of contents based on the document headings\"\n\"Add page numbers in the footer and our company name in the header\"\n\"Insert a cross-reference to Heading 2 in paragraph 5\"\n```\n\n## Usage Examples\n\n### Example 1: Read a document (cross-platform)\n\n**Tool call:** `get_document_text`\n```json\n{ \"filename\": \"C:/Documents/report.docx\" }\n```\n**Expected output:**\n```json\n{\n  \"status\": \"success\",\n  \"paragraphs\": [\n    {\"index\": 0, \"text\": \"Quarterly Report\", \"style\": \"Heading 1\"},\n    {\"index\": 1, \"text\": \"Revenue increased by 15% compared to Q3.\", \"style\": \"Normal\"},\n    {\"index\": 2, \"text\": \"Key Metrics\", \"style\": \"Heading 2\"}\n  ],\n  \"total_paragraphs\": 3\n}\n```\n\n### Example 2: Live editing with tracked changes (Windows)\n\n**Tool call:** `word_live_replace_text`\n```json\n{\n  \"filename\": \"report.docx\",\n  \"find_text\": \"ABC Corporation\",\n  \"replace_text\": \"XYZ Ltd\",\n  \"match_case\": true,\n  \"replace_all\": true,\n  \"track_changes\": true\n}\n```\n**Expected output:**\n```json\n{\n  \"status\": \"success\",\n  \"replacements\": 4,\n  \"message\": \"Replaced 4 occurrences (tracked changes enabled)\"\n}\n```\nThe replacements appear as tracked changes in Word with strikethrough on \"ABC Corporation\" and underline on \"XYZ Ltd\".\n\n### Example 3: Add a comment anchored to text (cross-platform)\n\n**Tool call:** `add_comment`\n```json\n{\n  \"filename\": \"C:/Documents/contract.docx\",\n  \"target_text\": \"payment within 30 days\",\n  \"comment_text\": \"Should we extend this to 45 days?\",\n  \"author\": \"Jane Smith\"\n}\n```\n**Expected output:**\n```json\n{\n  \"status\": \"success\",\n  \"message\": \"Comment added by Jane Smith on 'payment within 30 days'\"\n}\n```\nThe comment appears in Word's Review panel, anchored to the specified text.\n\n## Tool Reference\n\n**124 tools** across two modes — see the [complete tool reference](TOOLS.md) for details.\n\n| Category | Count |\n|----------|-------|\n| Cross-platform (python-docx) | 80 |\n| Windows Live (COM automation) | 44 |\n| macOS Live (JXA automation) | 40 (of the 44 live tools) |\n\n## Requirements\n\n- **Python 3.11+**\n- `python-docx`, `fastmcp`, `msoffcrypto-tool` (installed automatically)\n- **Windows Live tools:** Windows 10/11 + Microsoft Word + `pywin32` (installed automatically)\n- **macOS Live tools:** macOS + Microsoft Word for Mac (uses built-in JXA — no extra dependencies)\n\n> The cross-platform tools work without Word installed — only python-docx is needed.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, code style, and how to add new tools.\n\nFound a bug? [Open an issue](https://github.com/ykarapazar/word-mcp-live/issues/new?template=bug_report.md).\nHave an idea? [Request a feature](https://github.com/ykarapazar/word-mcp-live/issues/new?template=feature_request.md).\n\n## Acknowledgments\n\nBuilt on top of [GongRzhe/Office-Word-MCP-Server](https://github.com/GongRzhe/Office-Word-MCP-Server) by GongRzhe (MIT License).\n\nAdditional libraries: [python-docx](https://python-docx.readthedocs.io/) &middot; [FastMCP](https://github.com/modelcontextprotocol/python-sdk) &middot; [pywin32](https://github.com/mhammond/pywin32)\n\n## Privacy\n\nThis server runs entirely on your local machine. No data is collected, transmitted, or stored. See the full [Privacy Policy](PRIVACY.md).\n\n## Support\n\n- **Bug reports:** [Open an issue](https://github.com/ykarapazar/word-mcp-live/issues/new?template=bug_report.md)\n- **Feature requests:** [Request a feature](https://github.com/ykarapazar/word-mcp-live/issues/new?template=feature_request.md)\n- **Discussions:** [GitHub Discussions](https://github.com/ykarapazar/word-mcp-live/discussions)\n\n## License\n\nMIT License — see [LICENSE](LICENSE) for details.\n\n## Star History\n\n<a href=\"https://star-history.com/#ykarapazar/word-mcp-live&Date\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=ykarapazar/word-mcp-live&type=Date&theme=dark\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=ykarapazar/word-mcp-live&type=Date\" />\n   <img alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=ykarapazar/word-mcp-live&type=Date\" />\n </picture>\n</a>\n\n<!-- mcp-name: io.github.ykarapazar/word-mcp-live -->\n",
  "bytes": 11400,
  "sha": "cae3f755988e848de539ec73839d7e6808b29f1735e0d058315578cb91f8f4a1",
  "repo_slug": "ykarapazar/word-mcp-live",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ykarapazar_word_mcp_live_0610e3a5/readme"
}