word-mcp-live
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
word-mcp-live
The only MCP server that edits Word documents while they're open
Live editing · Tracked changes · Per-action undo · 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 open document.
Without word-mcp-live
AI can discuss your document but can't touch it
You copy-paste between AI and Word, losing formatting
Track changes? You do those manually after the fact
Every edit means save → close → process → reopen
With word-mcp-live
"Add a tracked change replacing ABC Corp with XYZ Ltd" — done
Changes appear live in your open Word document
Every AI edit is one Ctrl+Z away
Real tracked changes with your name, not XML hacks
See it in action
https://github.com/user-attachments/assets/fbb09af4-1e25-4e49-94d0-45b363278810
What Sets This Apart
Live editing — Edit documents while they're open in Word. No save-close-reopen cycle.
Full undo — Every AI action is a single Ctrl+Z. Made a mistake? Just undo it.
Native tracked changes — Real Word revisions with your name, not XML hacks.
Threaded comments — Add, reply, resolve, and delete comments like a human reviewer.
Layout diagnostics — Detects formatting problems before they become print disasters.
Equations & cross-references — Insert math formulas and auto-updating references.
Live and file-based tools — Choose only the tool groups needed for a session.
Related MCP server: word-mcp-live
Quick Start
pip install word-mcp-liveOr install from source:
git clone https://github.com/ykarapazar/word-mcp-live.git
cd word-mcp-live
pip install -e .Client Installation
Limit tool discovery
Set WORD_MCP_TOOLSETS in the MCP server's environment to a comma-separated
list of groups. For example, live exposes only tools for documents open in
Word; live,comments exposes all live tools and file-based comment tools.
Groups are combined as a union, not an intersection. Available groups are
live, file, comments, tables, footnotes, tracked_changes,
protection, and layout. A tool can belong to more than one group. Unset,
empty, or all exposes the complete existing tool list. Unknown group names
cause startup to fail. Restart the server after changing this setting.
Filtering limits discovery and available tools; it is not an authorization mechanism. Live tools require Word, and individual capabilities vary between Windows and macOS. File tools require the document to be closed in Word. Existing names remain available by default for client compatibility.
Set WORD_MCP_LEGACY_TOOLS=false to exclude legacy footnote tools and the
horizontal/vertical table-merge aliases. Use add_footnote, delete_footnote
and merge_table_cells instead. This is opt-in: old tools have different
signatures and, in some cases, different behavior; see the migration notes in
TOOLS.md. Restart after changing it.
Add to your claude_desktop_config.json:
{
"mcpServers": {
"word": {
"command": "uvx",
"args": ["word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}Add to your .mcp.json:
{
"mcpServers": {
"word": {
"command": "uvx",
"args": ["word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}One-click: Click the install button at the top of this page.
Manual: Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"word": {
"command": "uvx",
"args": ["word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}One-click: Install in VS Code
Manual: Add to your VS Code settings.json:
{
"mcp": {
"servers": {
"word": {
"command": "uvx",
"args": ["word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"word": {
"command": "uvx",
"args": ["word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}{
"mcpServers": {
"word": {
"command": "docker",
"args": ["run", "-i", "--rm", "ghcr.io/ykarapazar/word-mcp-live"],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}Note: Docker mode supports cross-platform tools only. Live editing requires a native Windows install.
MCP_AUTHORsets your name on tracked changes and comments (default:"Author").MCP_AUTHOR_INITIALSsets comment initials.
Two Modes
Works everywhere | Live editing (Word open) | |
What it does | Create and edit saved .docx files | Edit documents live while you work in Word |
Platform | Windows, macOS, Linux | Windows (COM) and macOS (JXA) |
Undo | File-level saves | Per-action Ctrl+Z (Windows); per-operation undo (macOS) |
Best for | Batch processing, document generation | Interactive editing, formatting, review |
Both modes work together. The AI picks the right one for the task.
macOS Live Editing (New in v1.5.0)
Live 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.
Feature | Windows | macOS |
Text read/write/find/replace | COM | JXA |
Formatting (bold, font, style) | COM | JXA |
Track changes & revisions | COM | JXA |
Comments (add, delete, list) | COM | JXA |
Tables (read, write, add rows) | COM | JXA |
Page layout, headers, bookmarks | COM | JXA |
Equations, cross-references | COM | JXA |
Threaded comment replies | COM | Not available |
Comment resolve/unresolve | COM | Not available |
Undo history inspection | COM | Not available |
Watermarks | COM | Not available |
Configuration
Variable | Default | Description |
|
| Author name for tracked changes and comments |
|
| Author initials for comments |
|
| Transport type: |
|
| Host to bind (for SSE/HTTP transports) |
|
| Port to bind (for SSE/HTTP transports) |
For remote deployment, see RENDER_DEPLOYMENT.md.
Example Prompts
Just tell the AI what you want in plain language:
"Draft a contract with tracked changes so my colleague can review"
"Format all headings as Cambria 13pt bold and add automatic numbering"
"Add a comment on paragraph 3 asking about the deadline"
"Find every mention of 'ABC Corp' and replace with 'XYZ Ltd' as a tracked change"
"Set the page to A4 landscape with 2cm margins"
"Insert a table of contents based on the document headings"
"Add page numbers in the footer and our company name in the header"
"Insert a cross-reference to Heading 2 in paragraph 5"Usage Examples
Example 1: Read a document (cross-platform)
Tool call: get_document_text
{ "filename": "C:/Documents/report.docx" }Expected output:
{
"status": "success",
"paragraphs": [
{"index": 0, "text": "Quarterly Report", "style": "Heading 1"},
{"index": 1, "text": "Revenue increased by 15% compared to Q3.", "style": "Normal"},
{"index": 2, "text": "Key Metrics", "style": "Heading 2"}
],
"total_paragraphs": 3
}Example 2: Live editing with tracked changes (Windows)
Tool call: word_live_replace_text
{
"filename": "report.docx",
"find_text": "ABC Corporation",
"replace_text": "XYZ Ltd",
"match_case": true,
"replace_all": true,
"track_changes": true
}Expected output:
{
"status": "success",
"replacements": 4,
"message": "Replaced 4 occurrences (tracked changes enabled)"
}The replacements appear as tracked changes in Word with strikethrough on "ABC Corporation" and underline on "XYZ Ltd".
Example 3: Add a comment anchored to text (cross-platform)
Tool call: add_comment
{
"filename": "C:/Documents/contract.docx",
"target_text": "payment within 30 days",
"comment_text": "Should we extend this to 45 days?",
"author": "Jane Smith"
}Expected output:
{
"status": "success",
"message": "Comment added by Jane Smith on 'payment within 30 days'"
}The comment appears in Word's Review panel, anchored to the specified text.
Tool Reference
124 tools across two modes — see the complete tool reference for details.
Category | Count |
Cross-platform (python-docx) | 80 |
Windows Live (COM automation) | 44 |
macOS Live (JXA automation) | 40 (of the 44 live tools) |
Requirements
Python 3.11+
python-docx,fastmcp,msoffcrypto-tool(installed automatically)Windows Live tools: Windows 10/11 + Microsoft Word +
pywin32(installed automatically)macOS Live tools: macOS + Microsoft Word for Mac (uses built-in JXA — no extra dependencies)
The cross-platform tools work without Word installed — only python-docx is needed.
Contributing
See CONTRIBUTING.md for development setup, code style, and how to add new tools.
Found a bug? Open an issue. Have an idea? Request a feature.
Acknowledgments
Built on top of GongRzhe/Office-Word-MCP-Server by GongRzhe (MIT License).
Additional libraries: python-docx · FastMCP · pywin32
Privacy
This server runs entirely on your local machine. No data is collected, transmitted, or stored. See the full Privacy Policy.
Support
Bug reports: Open an issue
Feature requests: Request a feature
Discussions: GitHub Discussions
License
MIT License — see LICENSE for details.
Star History
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
Document editing, AI writing, saved documents, DOCX downloads, PDF, STT, TTS and watermarking
Online office suite for AI agents: edit docs, sheets, slides and PDFs in browser or via MCP.
AI document editing: edits the exact section, leaves the rest. 38 MCP tools; agent self-signup.
Related MCP Servers
- AlicenseBqualityNot gradedmaintenanceEnables AI assistants to create, read, and manipulate Microsoft Word documents with comprehensive formatting, table creation, content management, and document protection capabilities. Supports advanced operations like merging documents, PDF conversion, and rich text formatting through a standardized interface.32MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to edit Microsoft Word documents live while they are open, with full support for tracked changes, comments, formatting, and 124 tools.1,127 PyPI273MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to directly read, edit, and manipulate Word documents, supporting image and table operations, paragraph editing, and search/replace.202MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create, read, and manipulate Microsoft Word documents with rich editing capabilities.MIT