word-mcp-live
The only MCP server that edits Word documents while they're open
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
uvx word-mcp-live==1.2.0Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
MCP_AUTHOR=<value> MCP_AUTHOR_INITIALS=<value> claude mcp add ykarapazar-word-mcp-live -- uvx word-mcp-live==1.2.0在終端機中執行。
{ "mcpServers": { "ykarapazar-word-mcp-live": { "command": "uvx", "args": [ "word-mcp-live==1.2.0" ], "env": { "MCP_AUTHOR": "<value>", "MCP_AUTHOR_INITIALS": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
Live editing · Tracked changes · Per-action undo · 124 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 open document.
pip install word-mcp-live
Or install from source:
git clone https://github.com/ykarapazar/word-mcp-live.git
cd word-mcp-live
pip install -e .
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.
Both modes work together. The AI picks the right one for the task.
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.
For remote deployment, see RENDER_DEPLOYMENT.md.
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"
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
}
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".
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.
124 tools across two modes — see the complete tool reference for details.
python-docx, fastmcp, msoffcrypto-tool (installed automatically)pywin32 (installed automatically)The cross-platform tools work without Word installed — only python-docx is needed.
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.
Built on top of GongRzhe/Office-Word-MCP-Server by GongRzhe (MIT License).
Additional libraries: python-docx · FastMCP · pywin32
This server runs entirely on your local machine. No data is collected, transmitted, or stored. See the full Privacy Policy.
MIT License — see LICENSE for details.
The only MCP server that edits Word documents while they're open — 114 tools, live editing, tracked changes, per-action undo
{ "mcpServers": { "ykarapazar-word-mcp-live": { "command": "uvx", "args": [ "word-mcp-live==1.2.0" ], "env": { "MCP_AUTHOR": "<value>", "MCP_AUTHOR_INITIALS": "<value>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:MCP_AUTHOR, MCP_AUTHOR_INITIALS。
Word MCP Live 透過 stdio 在本機執行。
上次檢查時間:2026-11-11。 The only MCP server that edits Word documents while they're open — 114 tools, live editing, tracked changes, per-action undo