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.1

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

Built distribution (wheel)

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

Total release size: 43.3 kB

Release files / mcp_win_stdio_word-0.4.1.tar.gz

Download URL mcp_win_stdio_word-0.4.1.tar.gz
Size 20.7 kB
Tags Source
SHA-256 checksum
How to use checksums
f486f676a4c3d2cef9dbd056c38f799d1788967b2a2ff2c29d80fc3418e9a808
BLAKE2b-256 checksum
How to use checksums
e358e90603054613d868366fc278cc2a2e904449910239c5c320c09f2c195b55
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.1-py3-none-any.whl

Download URL mcp_win_stdio_word-0.4.1-py3-none-any.whl
Size 22.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fa271998a67116b1a3855f771ffc1f13972e6a2dc3ab01cc36331f96c7a39cb1
BLAKE2b-256 checksum
How to use checksums
c39ba34e066f690dc5bd5209091a25c186bae55c1d177fb52c0714647a7e0d4e
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.1

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