Skip to main content

mcp-win-stdio-word

Windows-optimized Model Context Protocol (MCP) server for Microsoft Word documents (.docx and .doc): 20 high-precision inspection, layout geometry, typography, document authoring, templating, and native COM PDF export tools for Claude.

Part of the mcp-win-stdio Windows-optimized suite.


🚀 Features (20 Tools)

  • Complete Document Authoring: Create new .docx documents (create_document) with paper sizes (A4, Letter, Legal, A3), orientations, margins, and core metadata.
  • Rich Paragraphs & Headings: Append formatted headings (add_heading) and paragraphs (add_paragraph) with custom font families, sizes, hex colors, alignments, and line spacing.
  • Automated Template Population: Fill placeholder tokens like {{client_name}} and {{invoice_date}} (fill_template) across paragraphs, tables, and headers/footers while preserving styling.
  • Native Windows Word COM PDF Export: High-fidelity .pdf generation (export_to_pdf) powered by Microsoft Word desktop automation.
  • Find, Replace & Images: Document-wide search & replace (replace_text) and image embedding with dimension scaling and captions (insert_image).
  • Advanced Page Layout Geometry: Extracts paper sizes, exact margins across 4 units (inches, cm, mm, pt), printable area, and multi-column layout (IEEE / academic style).
  • Paragraph Spacing & Indentation: Inspects line spacing, space before/after, first-line & hanging indents, and widow/orphan control.
  • Typography & Formatting: Extracts font families, sizes in pt, hex colors, highlights, and paragraph alignments.
  • Tables, Outlines & Reader: Extracts tables in Markdown or structured JSON, outlines, and complete document bodies.

🛠️ Included Tools (20 Tools)

  1. get_document_layout: Paper sizes, margins in 4 units (in, cm, mm, pt), multi-column layout, printable area.
  2. get_paragraph_spacing_and_indentation: Line spacing, space before/after (pt), first-line & hanging indents.
  3. get_document_typography: Font names, sizes (pt), hex colors, highlights, text alignment.
  4. get_document_images: Images across body, headers, footers, tables with positioning and dimensions.
  5. get_headers_and_footers: Primary, first-page, and even/odd headers/footers with typography.
  6. get_document_tables: Extracts all tables in clean Markdown or structured JSON.
  7. get_document_outline: Heading hierarchy (Title, Heading 1 - 4) with paragraph indices.
  8. get_document_metadata: Author, title, revision, word count, timestamps.
  9. read_word_document: Complete body paragraphs, tables, and headers with formatting.
  10. search_word_document: Keyword and regex search across body, headers, footers, and tables.
  11. edit_paragraph: Modifies existing paragraph text, style, or formatting in place.
  12. insert_table: Inserts a new formatted table with headers and data rows.
  13. inspect_revisions_and_comments: Extracts comments, tracked insertions, and tracked deletions.
  14. create_document: Creates a new empty .docx file with custom page setup, paper size, orientation, and margins.
  15. add_paragraph: Appends a styled paragraph with custom font family, size, bold, italic, hex color, alignment, spacing.
  16. add_heading: Appends a heading (level 1-9) or Title (level 0).
  17. fill_template: Populates placeholders across paragraphs, tables, and headers/footers while preserving styles.
  18. replace_text: Global find-and-replace across the entire document.
  19. insert_image: Inserts an image with dimensions and optional caption.
  20. export_to_pdf: Exports .docx to high-fidelity PDF using native Windows Word COM automation.

📦 Installation

pip install mcp-win-stdio-word

(Installing this package automatically installs mws CLI orchestrator).


🚀 One-Command Claude Setup

mws setup word
# or:
mws add word

Manual Configuration Example

In %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "word": {
      "command": "python",
      "args": ["-m", "mcp_win_stdio.word"]
    }
  }
}

📖 CLI Commands & Interactive Guide

mws word guide      # Complete tool reference & prompt recipes
mws word doctor     # Verify python-docx and PyWin32 COM readiness
mws word setup      # Configure Claude Desktop / Claude Code
mws word run        # Launch server over stdio

📜 License

MIT License. Copyright (c) 2026 Mohan Kumar Indala.

Metadata

Release files for mcp-win-stdio-word 0.4.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-win-stdio-word 0.4.5
File Size Uploaded Provenance Actions
mcp_win_stdio_word-0.4.5.tar.gz 20.7 kB Without provenance Details for mcp_win_stdio_word-0.4.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-win-stdio-word 0.4.5
File Interpreter ABI Platform Actions
mcp_win_stdio_word-0.4.5-py3-none-any.whl Python 3 none any Details for mcp_win_stdio_word-0.4.5-py3-none-any.whl

Total release size: 43.3 kB

Release files / mcp_win_stdio_word-0.4.5.tar.gz

Download URL mcp_win_stdio_word-0.4.5.tar.gz
Size 20.7 kB
Tags Source
SHA-256 checksum
How to use checksums
e678acda421078a7064ce5f9950cb566b0eda3ca5d33c6a9c1631654a69f48bc
BLAKE2b-256 checksum
How to use checksums
66d793f942a18f3a88e329e5aabee133be077b76da2589d1934e57701e7fc287
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / mcp_win_stdio_word-0.4.5-py3-none-any.whl

Download URL mcp_win_stdio_word-0.4.5-py3-none-any.whl
Size 22.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b505355744db4d48b1d99e599b1774ff0e6d706e826f5c10d6e1ff88289c9e16
BLAKE2b-256 checksum
How to use checksums
1335bb21fc596b945b059c7a1f25bb83e4464409077617eeb9f2de6639e4ec64
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for mcp-win-stdio-word 0.4.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page