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.2.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.2.5
File Size Uploaded Provenance Actions
mcp_win_stdio_word-0.2.5.tar.gz 20.7 kB Without provenance Details for mcp_win_stdio_word-0.2.5.tar.gz

Built distribution (wheel)

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

Total release size: 43.3 kB

Release files / mcp_win_stdio_word-0.2.5.tar.gz

Download URL mcp_win_stdio_word-0.2.5.tar.gz
Size 20.7 kB
Tags Source
SHA-256 checksum
How to use checksums
21bd22cd8e3077860b6207fc77d95e5a010ad6c8c18285db7512619d2f8e8b1a
BLAKE2b-256 checksum
How to use checksums
0b6799d9a7b742caf48a56223da50da618d5b05d45126da91325179c7edfbde1
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.2.5-py3-none-any.whl

Download URL mcp_win_stdio_word-0.2.5-py3-none-any.whl
Size 22.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
70164709279b9f5defa25df6299dd7c435949ec936090254247bf96061a8e1f9
BLAKE2b-256 checksum
How to use checksums
c0445588d199e0f61265089e64185ea909ba0ddcdb651e53f765bdceb36dd48f
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.2.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