# docx4j Word documents (oci · ghcr.io/plutext/docx4j-mcp:0.2.0) Read, convert and fill Word (.docx) documents: templates, Markdown/HTML in and out, PDF with math. - Trust score: 43/100 (low) - Change this week: +6 - Registry status: active - Liveness: live - Owner verified: no - Last scored: 2026-09-21 ## Components - mcpb · `docx4j-mcp.mcpb`: 13/100, [markdown](https://verifymcp.io/servers/plutext-docx4j-mcp/https-github-com-plutext-docx4j-mcp-releases-download-v0-2-0-docx4j-mcp-mcpb.md), [page](https://verifymcp.io/servers/plutext-docx4j-mcp/https-github-com-plutext-docx4j-mcp-releases-download-v0-2-0-docx4j-mcp-mcpb) - oci · `ghcr.io/plutext/docx4j-mcp:0.2.0`: 43/100 (this document), [markdown](https://verifymcp.io/servers/plutext-docx4j-mcp/ghcr-io-plutext-docx4j-mcp-0-2-0.md), [page](https://verifymcp.io/servers/plutext-docx4j-mcp/ghcr-io-plutext-docx4j-mcp-0-2-0) ## Channel facts - Registry: `oci` - Package: `ghcr.io/plutext/docx4j-mcp:0.2.0` - Transport: `stdio` ## Trust breakdown How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog) Scored 2026-09-21. - **Supply Chain Security**: 0/100 - Malware scan not yet available for this package. - Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it. - Install-script risk not yet assessed. - Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it. - **Provenance & Transparency**: 32/100 - Source repository is publicly reachable at the declared URL. - Provenance check failed: no build-provenance attestation is published. - License check failed: no license is declared. - Actively maintained (last published 34 days ago). - Disclosure check failed: no security disclosure policy was found in the source repository. - **Schema Quality & AI Usability**: 70/100 - AI-judged instruction clarity (excellent). - Context-footprint check failed: tool/resource definitions use about 1693 tokens (~211/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params. - Usage-examples check failed: none of the tools include examples. - **Stability & Change Management**: 43/100 - Stability observed for 13 of 30 days with no destabilising changes; credit accrues until the full window elapses. - **Tool Coverage**: 100/100 - 100% of tools have a non-trivial description (not blank, and not just the tool's name). - 100% of tool parameters carry a description. - **Tool Safety**: 100/100 - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured. - We read all 8 captured tool definition(s), and no name or description among them implies an irreversible operation. - An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it. - **Capabilities**: 100/100 - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28. **Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm. ## Install ### How do I install the docx4j Word documents MCP server? docx4j Word documents runs locally as a container image, launched with docker run --rm -i ghcr.io/plutext/docx4j-mcp:0.2.0. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation. ### Claude ```bash claude mcp add plutext-docx4j-mcp -- docker run --rm -i ghcr.io/plutext/docx4j-mcp:0.2.0 ``` ### Cursor ```json { "mcpServers": { "plutext-docx4j-mcp": { "command": "docker", "args": [ "run", "--rm", "-i", "ghcr.io/plutext/docx4j-mcp:0.2.0" ] } } } ``` ### VS Code ```json { "servers": { "plutext-docx4j-mcp": { "command": "docker", "args": [ "run", "--rm", "-i", "ghcr.io/plutext/docx4j-mcp:0.2.0" ] } } } ``` ### Codex ```bash codex mcp add plutext-docx4j-mcp -- docker run --rm -i ghcr.io/plutext/docx4j-mcp:0.2.0 ``` ### opencode ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "plutext-docx4j-mcp": { "type": "local", "command": [ "docker", "run", "--rm", "-i", "ghcr.io/plutext/docx4j-mcp:0.2.0" ], "enabled": true } } } ``` ### Hermes ```yaml mcp_servers: plutext-docx4j-mcp: command: "docker" args: ["run", "--rm", "-i", "ghcr.io/plutext/docx4j-mcp:0.2.0"] ``` ### Netclaw ```json { "McpServers": { "plutext-docx4j-mcp": { "Transport": "stdio", "Command": "docker", "Arguments": [ "run", "--rm", "-i", "ghcr.io/plutext/docx4j-mcp:0.2.0" ] } } } ``` ### Other ```json { "mcpServers": { "plutext-docx4j-mcp": { "command": "docker", "args": [ "run", "--rm", "-i", "ghcr.io/plutext/docx4j-mcp:0.2.0" ] } } } ``` ## Changelog Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims. ### 2026-09-20 (score 43, +1) No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes. ### 2026-09-18 (score 42, +1) No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes. ### 2026-09-16 (score 41, +4) - [functional improvement] Stability: unverified → 0.27 ### 2026-09-08 (score 37) First indexed and scored. ## MCP tools (8) ### `describe_template` (~86 tokens) Describe a docx template Inspects a Word template and reports what data it wants: for an OpenDoPE or content-control template, the skeleton XML to fill in (with the bound xpaths, repeats and conditions); for a mail-merge template, the MERGEFIELD names. Call this before fill_template. Input parameters: - `template_path` (string, required): Path to the .docx template (inside an allowed root) ### `fill_template` (~252 tokens) Fill a docx template Fills a Word template deterministically, preserving all its formatting. OpenDoPE and bound content-control templates take 'data' as an XML string (repeats and conditions are processed); mail-merge templates take 'data' as a JSON object of MERGEFIELD name to value. Use describe_template first to learn which, and what the data should look like. Input parameters: - `data` (string|object, required): For OpenDoPE / content-control templates: the filled-in XML document as a string (start from describe_template's skeleton_xml). For mail-merge templates: a JSON object mapping MERGEFIELD names to val… - `headers_footers` (boolean): Mail-merge mode: also merge fields in headers and footers (default true) - `output_path` (string, required): Where to write the filled .docx - `overwrite` (boolean): Replace output_path if it exists (default false) - `remove_sdts` (boolean): XML mode: strip the content-control wrappers from the result (default true) - `remove_xml` (boolean): XML mode: drop the custom XML data part from the result (default true) - `template_path` (string, required): Path to the .docx template ### `convert_to_pdf` (~186 tokens) Convert docx to PDF Renders a Word document to PDF with docx4j's XSL-FO exporter (Apache FOP). Equations (OMML) are rendered (a very long single display equation will not line-wrap). Reports which fonts were substituted, so you can tell the user if the output may differ from Word. Input parameters: - `input_path` (string, required): Path to the .docx - `output_path` (string, required): Where to write the PDF - `overwrite` (boolean): Replace output_path if it exists (default false) - `update_toc` (boolean): Regenerate the document's table of contents (entries and page numbers) before rendering, so it matches the output (default false; no effect if the document has no ToC) - `use_xslt` (boolean): Use the older XSLT-based exporter instead of the default visitor exporter (default false) ### `markdown_to_docx` (~207 tokens) Convert Markdown to docx Creates a properly styled Word document from Markdown: headings, lists and numbering, GFM tables, code, footnotes and task lists become native Word constructs (no HTML detour), and TeX math ($..$ / $$..$$) becomes real, editable Word equations (OMML) that also render in PDF/HTML export. Give a styles_template_path to inherit an organisation's styles. Remote images are not fetched. Input parameters: - `input_path` (string): Alternatively, path to a .md file - `markdown` (string): The Markdown text (CommonMark + GFM tables, task lists, footnotes; $..$ TeX math) - `output_path` (string, required): Where to write the .docx - `overwrite` (boolean): Replace output_path if it exists (default false) - `styles_template_path` (string): Optional .docx whose styles, numbering, page setup and headers/footers the output should use; its body content is replaced ### `docx_to_markdown` (~185 tokens) Convert docx to Markdown Reads a Word document as Markdown (CommonMark + GFM): headings, lists, tables, footnotes and links are preserved as Markdown structure, and Word equations (OMML) become $..$ TeX math. Prefer this over extract_text when structure matters. Large results are truncated inline unless output_path is given. Input parameters: - `image_dir_path` (string): Optional directory to extract images into (they are referenced from the Markdown); images are dropped otherwise - `input_path` (string, required): Path to the .docx - `output_path` (string): Optional: write the Markdown to this file (required if the result exceeds the inline limit) - `overwrite` (boolean): Replace output_path if it exists (default false) - `tracked_changes` (string): How to render tracked changes: accept them (default) or show insertions/deletions as markup ### `html_to_docx` (~298 tokens) Convert HTML to docx Creates a Word document from HTML using docx4j-ImportXHTML: headings, paragraphs, inline formatting, lists, tables, links and CSS become native Word markup, and (MathML) becomes real, editable Word equations. Give a styles_template_path to inherit an organisation's styles (class names matching style names map to those styles). Remote images are not fetched; use data: URIs or local files under an allowed root. Input parameters: - `base_path` (string): Directory (inside an allowed root) against which relative image paths are resolved; defaults to input_path's directory. Remote (http/https) images are never fetched. - `html` (string): The HTML (loose HTML is fine; CSS in style attributes and