← Back to directory
W

Word MCP Live

Community
The only MCP server that edits Word documents while they're open
Category
Collaboration #20 of 55
Stars
★ 233 Popular
Transport
stdio (local process)
Runtime
Python 3.11+ · Docker
Credentials
No credential needed
License
MIT
Last commit
Tools
3
57FMRS · C

Word MCP Live offers the most comprehensive Word editing capabilities, especially live editing and tracked changes. It suits scenarios where AI assists with document collaboration and formatting, but note that live features vary between Windows and macOS, and local installation is required.

Strongest · Setup experience 13/20 Weakest · Reliability 10/20

Reliability
10/20
Security and permissions
11/20
Maintenance
10/20
Documentation
13/20
Setup experience
13/20
Why each score
Reliability 10/20
Static review found no obvious contradictions or poor error handling in the source. README claims 124 tools, but server.json packages only lists the PyPI package without tool list. No tests and CI configuration are provided as execution evidence, so many claims cannot be verified. The documentation states Docker mode supports only cross-platform tools, but the README does not clearly explain the mode selection logic for local live editing, which is also unverified. Since no reproducible test evidence is provided, reliability is capped at 12.
Security and permissions 11/20
No evidence of malicious code, credential theft, or data exfiltration. Environment variables MCP_AUTHOR and MCP_AUTHOR_INITIALS are non-secret and optional. README claims fully local operation. However, both cross-platform and live tools have file-reading/writing behavior via filename parameters, which could be vulnerable to path traversal if not properly validated. The absence of explicit security documentation detailing permission boundaries and mitigations prevents a higher score.
Maintenance 10/20
Repository is active with 16 open issues, but issue response details are not provided. Version 1.3.0 in manifest contradicts README mentioning v1.5.0, indicating release management inconsistencies. MIT license is present, but no maintainer contact or security response channel is found. Static review cannot verify commit frequency or dependency updates, so maintenance cannot be rated highly.
Documentation 13/20
README provides many installation examples, two modes, and a link to tool reference, but lacks complete tool parameters, limitations, costs, or troubleshooting. Tool count of 124 is claimed but only limited examples are shown. README claims macOS live editing supports some features, but the table shows unsupported features like threaded comment replies and undo history, which are contradictory. These gaps reduce the documentation score.
Setup experience 13/20
Configuration examples for multiple clients (Claude Desktop, Cursor, etc.) are provided. However, setup is capped at 15 due to lack of verifiable CI and test evidence. Installation steps may be complex for non-Python users, and platform dependencies (Windows COM vs macOS JXA) are not fully explained in the examples. Common platform-specific issues are not addressed.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local files

Best for

  • Interactive editing sessions where documents are open in Word (Windows/macOS).
  • Collaborative review where AI generates tracked changes and comments.
  • Cross-platform creation and editing of .docx files without needing Word installed.

Not for

  • Full cross-platform live features (some live tools are Windows-only, macOS has limitations).
  • Team collaboration requiring online sync (server runs entirely locally).
  • Non-technical users needing a GUI or no-code setup.

Required permissions

  • Access to the local file system to read and write .docx files.
  • Automation control of Microsoft Word via COM (Windows) or JXA (macOS).
  • Ability to modify document content, including tracked changes, comments, formatting, etc.

Risks and side effects

  • AI may accidentally modify wrong content; use tracked changes and undo to mitigate.
  • Live editing depends on Word automation, which may be affected by Word version or permissions.
  • Local-only operation ensures no data is collected, but document privacy is still a consideration.

Setup

Before you start

Runtime:Python 3.11+ · Docker

Other optional settings (5)
MCP_AUTHOR optional Author name shown on tracked changes and comments; default "Author"; set it yourself, nothing to obtain.
MCP_AUTHOR_INITIALS optional Author initials shown on comments; default is empty; fill in your own initials.
MCP_TRANSPORT optional Transport type: stdio, sse, or streamable-http; defaults to stdio.
MCP_HOST optional Host to bind for SSE/HTTP transports; defaults to 0.0.0.0.
MCP_PORT optional Port to bind for SSE/HTTP transports; defaults to 8000.
  1. Install Python 3.11+.
  2. Run pip install word-mcp-live.
  3. Add configuration to your client (e.g., Claude Desktop's claude_desktop_config.json) using the uvx command. Optionally set environment variables MCP_AUTHOR and MCP_AUTHOR_INITIALS.
claude_desktop_config.json
{
  "mcpServers": {
    "word": {
      "command": "uvx",
      "args": ["word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "word": {
      "command": "uvx",
      "args": [
        "word-mcp-live"
      ],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add word -e 'MCP_AUTHOR=Your Name' -e MCP_AUTHOR_INITIALS=YN -- uvx word-mcp-live

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

After adding the config and restarting the client, ask it to read a .docx file with get_document_text; the tool should appear in the client's tool list and return the document's paragraphs.

Troubleshooting

  1. Ensure Python 3.11+ and Word are installed (required for live tools).
  2. For Windows, ensure pywin32 is installed; macOS uses built-in JXA with no extra dependencies.
  3. If connection fails, check that `uvx` is available and the MCP config environment variables are set correctly.

Things to try

Once connected, you can ask your AI assistant things like:

  • Read the text of C:/Documents/report.docx and summarize the headings.
  • Replace every mention of 'ABC Corporation' with 'XYZ Ltd' in report.docx as a tracked change.
  • Add a comment on the text 'payment within 30 days' in contract.docx asking whether to extend it to 45 days.
  • Format all headings as Cambria 13pt bold with automatic numbering.

Tools 3

get_document_text read-only
Reads the full text of a document with paragraph styles.
word_live_replace_text writes
Finds and replaces text in an open Word document, optionally tracked.
add_comment writes
Adds a comment anchored to specified text in the document.

Use cases

Ask AI to draft a contract with tracked changes for colleague review.
Real-time editing of open Word documents: formatting, comments, text replacement.
Batch process .docx files for report generation or content updates.

Supported clients

Claude Desktop
Claude Code
Cursor
VS Code
Windsurf

Listed from the project's documentation, not tested by this site.

Overview

Word MCP Live is an MCP server that gives AI assistants (like Claude, Cursor) full control of Microsoft Word via MCP. It supports live editing (changes appear while Word is open), tracked changes, comments, per-action undo, and more. It offers 124 tools across two modes: cross-platform (python-docx) and live (Windows COM, macOS JXA). It allows AI to add tracked changes and comments in your name, and every AI edit is one Ctrl+Z away.

Similar servers

Source revision 12bbff97873b Data synced 2026-10-12 Read the FMRS scoring method