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
.docxdocuments (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
.pdfgeneration (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)
get_document_layout: Paper sizes, margins in 4 units (in, cm, mm, pt), multi-column layout, printable area.get_paragraph_spacing_and_indentation: Line spacing, space before/after (pt), first-line & hanging indents.get_document_typography: Font names, sizes (pt), hex colors, highlights, text alignment.get_document_images: Images across body, headers, footers, tables with positioning and dimensions.get_headers_and_footers: Primary, first-page, and even/odd headers/footers with typography.get_document_tables: Extracts all tables in clean Markdown or structured JSON.get_document_outline: Heading hierarchy (Title, Heading 1 - 4) with paragraph indices.get_document_metadata: Author, title, revision, word count, timestamps.read_word_document: Complete body paragraphs, tables, and headers with formatting.search_word_document: Keyword and regex search across body, headers, footers, and tables.edit_paragraph: Modifies existing paragraph text, style, or formatting in place.insert_table: Inserts a new formatted table with headers and data rows.inspect_revisions_and_comments: Extracts comments, tracked insertions, and tracked deletions.create_document: Creates a new empty .docx file with custom page setup, paper size, orientation, and margins.add_paragraph: Appends a styled paragraph with custom font family, size, bold, italic, hex color, alignment, spacing.add_heading: Appends a heading (level 1-9) or Title (level 0).fill_template: Populates placeholders across paragraphs, tables, and headers/footers while preserving styles.replace_text: Global find-and-replace across the entire document.insert_image: Inserts an image with dimensions and optional caption.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.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_win_stdio_word-0.3.2.tar.gz | 20.6 kB | Without provenance | Details for mcp_win_stdio_word-0.3.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_win_stdio_word-0.3.2-py3-none-any.whl | Python 3 | none | any | Details for mcp_win_stdio_word-0.3.2-py3-none-any.whl |
Total release size: 43.1 kB
Release files / mcp_win_stdio_word-0.3.2.tar.gz
| Download URL | mcp_win_stdio_word-0.3.2.tar.gz |
|---|---|
| Size | 20.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
07b9267b343f4e0d294f4ebf66c677ac62872147f5059065d671c44947628a3c
|
|
BLAKE2b-256 checksum How to use checksums |
d939dcaeac3ee31af54702a1e507ebdf225f20938c6ebd1184e9c3ed4259b255
|
| 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.3.2-py3-none-any.whl
| Download URL | mcp_win_stdio_word-0.3.2-py3-none-any.whl |
|---|---|
| Size | 22.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
28f6064c05dc026a3dd086b0453edcfecb2b67ed3b2d326bca8247b6b929990b
|
|
BLAKE2b-256 checksum How to use checksums |
b487a84129bf3e2dd147fbfff06978e92a2788ed641abc1729ff6676e17f4c29
|
| 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.3.2
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.