msword-mcp
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.
msword-mcp
High-performance Word MCP Server — Live editing in Microsoft Word, Academic Publishing Presets, and OpenXML manipulation
Live editing · Academic & SINTA Presets · Metric Units (cm/mm) · Native TOC · Token Bloat Filtering · Tracked changes
msword-mcp (enhanced fork) gives any AI assistant that supports MCP full control of Microsoft Word (including Google Antigravity, Cursor, Claude Desktop, VS Code, Windsurf, and Codex). Open a document, tell the AI what you need, and watch it happen — formatting, academic thesis layouts, multi-column journal structures, tracked changes, comments, and all. Changes can appear live in your open Word window or be processed offline directly via OpenXML.
Without msword-mcp
AI can discuss your document but can't touch it
You copy-paste between AI and Word, losing formatting
Manual margin calculation (converting cm to inches manually)
Academic page numbering (Roman vs Arabic, different first page per chapter) is painful
Track changes? You do those manually after the fact
With msword-mcp
"Apply Indonesian thesis preset with 4-4-3-3 cm margins" — done in 1 call
"Setup SINTA 2-column journal template" — done automatically
Changes appear live in your open Word document
Native Word TOC fields with dot leaders and auto-update
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
Academic, Thesis & SINTA Presets — 1-call setup for Indonesian Thesis (
4-4-3-3 cm, Roman prelims, Arabic chapters with different first page), SINTA 2-column articles, and Makalah.Metric Unit Support — Configure margins and paper sizes directly in centimeters (
cm), millimeters (mm), points (pt), or inches.Native Word TOC (<w:fldSimple>) — Clean XML fields that auto-update in Word with right tab stop dot leaders.
Token Bloat Reduction (
WORD_MCP_TOOLSET) — Switch betweenminimal(10 tools),academic(30 tools),live_only(45 tools), orfullprofiles to save up to 75% LLM context window.Office 365 / OneDrive COM Reliability — ROT fallback scanning and clear
PermissionError [Errno 13]handling when files are open in Word GUI.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.
Related MCP server: MCP Word Commander
Quick Start
Install from source:
git clone https://github.com/RvlDX/msword-mcp.git
cd msword-mcp
pip install -e .Client Installation
Add to your Antigravity MCP configuration (mcp_config.json or Antigravity MCP Settings):
{
"mcpServers": {
"word": {
"command": "python",
"args": ["-m", "word_document_server.main"],
"env": {
"MCP_AUTHOR": "Your Name",
"WORD_MCP_TOOLSET": "academic"
}
}
}
}Or via Antigravity CLI:
agy mcp add word -- python -m word_document_server.mainAdd 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"
}
}
}
}codex mcp add word --env MCP_AUTHOR="Your Name" -- uvx word-mcp-liveOr add to ~/.codex/config.toml:
[mcp_servers.word]
command = "uvx"
args = ["word-mcp-live"]
startup_timeout_sec = 60
tool_timeout_sec = 120
[mcp_servers.word.env]
MCP_AUTHOR = "Your Name"In the desktop app: Settings → MCP servers → Add server. On Windows, run Codex natively, not under WSL — live tools need native Windows.
{
"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 (non-Docker) install on Windows or macOS with Word running.
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 (add, read, modify rows/cells) | COM | JXA |
Page layout, headers, bookmarks | COM | JXA |
Table formatting ( | COM | Not available |
Images, multi-paragraph insert | COM | Not available |
Equations, cross-references | COM | Not available |
Snapshot diff/status, document properties | COM | Not available |
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) |
|
| Toolset filter profile to reduce context bloat: |
For remote deployment, see RENDER_DEPLOYMENT.md.
🎓 Academic, Thesis & Journal Publishing Support
msword-mcp is pre-configured with complete out-of-the-box support for academic guidelines (Indonesian Skripsi/Thesis, Makalah, and SINTA 1–6 / IEEE Journals):
1. Indonesian Thesis / Skripsi (indonesian_thesis)
Setup an entire compliant thesis structure with 1 tool call:
Paper & Margins: A4, 4-4-3-3 cm (Left 4 cm, Top 4 cm, Bottom 3 cm, Right 3 cm).
Typography: Times New Roman 12 pt, 1.5 line spacing, Justified alignment, 1.0 cm first-line indent.
Section & Academic Page Numbering:
Cover: No page numbers.
Preliminaries (Halaman Judul, Pengesahan, Abstrak, Daftar Isi): Lowercase Roman numerals (
i, ii, iii...), footer center.Chapters (BAB I s/d BAB V): Arabic numerals (
1, 2, 3...), restart at 1. First page of each chapter in bottom-center, subsequent pages in top-right.References (Daftar Pustaka): Continuous Arabic numbering in top-right.
// Tool call
apply_document_preset({"filename": "skripsi.docx", "preset": "indonesian_thesis"})2. SINTA Journal / IEEE 2-Column Articles (sinta_journal)
Compliant with Indonesian SINTA 1–6 and scientific conference templates:
Section 0 (Title, Authors, Abstract, Keywords): Single column (1-col).
Section 1 (Body: Pendahuluan, Metode, Hasil, Diskusi, Pustaka): Two columns (2-col, 0.65 cm spacing, continuous section break).
Typography: Times New Roman 10 pt, single spacing, 4 pt space after, Justified alignment, 0.75 cm indent.
// Tool call
apply_document_preset({"filename": "jurnal_sinta.docx", "preset": "sinta_journal"})3. Complete Thesis Skeleton Generation (setup_thesis_structure)
Generate a complete Indonesian thesis structure with 1 tool call:
Section 0: Cover (Judul, Penulis, Lembaga, Tahun).
Section 1: Halaman Awal (Lembar Pengesahan, Kata Pengantar, Abstrak ID & EN, Daftar Isi) dengan penomoran romawi (
i, ii, iii...).Section 2: Bab I Pendahuluan s.d. Bab V Penutup dengan penomoran arab (
1, 2, 3...) dan Heading 1 & Heading 2 lengkap.Section 3: Daftar Pustaka dan Lampiran.
// Tool call
setup_thesis_structure({
"filename": "skripsi_lengkap.docx",
"title": "Analisis Pengaruh Sistem Informasi Terhadap Kinerja Karyawan",
"author": "Nama Mahasiswa",
"nim": "12345678",
"institution": "Universitas Indonesia",
"faculty": "Fakultas Ilmu Komputer",
"city": "Jakarta",
"year": "2026"
})4. Academic Formatting Audit & Inline Annotations (audit_academic_formatting, annotate_audit_findings)
Automatically inspect a Word document against academic formatting standards (A4, margins 4-4-3-3 cm, Times New Roman 12 pt, 1.5 spacing, 1 cm first-line indent, and mandatory chapters):
audit_academic_formatting: Returns structured audit report with compliance score (0-100), passed checks, failed checks, and revision recommendations.annotate_audit_findings: Automatically injects native Word review comments anchored to problematic paragraphs.extract_citations_and_bibliography: Extracts in-text citations (APA/narrative) and cross-checks them against the Daftar Pustaka section.
5. Native Word Table of Contents (TOC)
Inserts native Word OpenXML fields (<w:fldSimple w:instr="TOC \o '1-3' \h \z \u"/>) with <w:updateFields/> so Word calculates exact page numbers when opened:
// Tool call
add_table_of_contents({
"filename": "skripsi.docx",
"title": "DAFTAR ISI",
"max_level": 3,
"use_native_field": true
})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
120 tools across two modes — see the complete tool reference for details.
Category | Count |
Cross-platform (python-docx) | 75 |
Windows Live (COM automation) | 45 (44 |
macOS Live (JXA automation) | 32 (of the 45 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 ykarapazar/word-mcp-live and GongRzhe/Office-Word-MCP-Server (MIT License).
Academic writing skill workflow integrated with academic-writing-skills by Nbill27 (Indonesian academic writing rules, outline, drafting, EYD V editing, and research coherence audit).
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.
Use your own Word templates to convert Markdown → DOCX/PDF/HTML from any MCP-compatible AI.
Turn Markdown and AI answers into Word (.docx) with native equations, or into PDF.
Document editing, AI writing, saved documents, DOCX downloads, PDF, STT, TTS and watermarking
Related MCP Servers
- 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.2,066 PyPI264MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to directly read, edit, and manipulate Word documents, supporting image and table operations, paragraph editing, and search/replace.202MIT
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to create, edit, and extract data from Microsoft Word documents programmatically, supporting document creation, content editing, table manipulation, parameter extraction, and template generation.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create, read, and manipulate Microsoft Word documents with rich editing capabilities.MIT