docx-viewer-mcp

Headless MCP access to document operations owned by OOXML core.

Live demo | npm | Full docs | Source

Repository-owned MCP schemas and server wiring. All document loading, editing and serialization delegate to ooxml-core/automation. Requires ooxml-core 0.11.0 or later, installed as a dependency.

Install

npm install docx-viewer-mcp

Quick start

{
	"mcpServers": {
		"docx": {
			"command": "npx",
			"args": ["-y", "--package=docx-viewer-mcp", "docx-tools", "/path/to/documents"]
		}
	}
}

Paths are scoped to the configured root (the current directory by default). Creation and save-as never overwrite existing files. Edit tools update the source unless outputPath names a new file. Files are written atomically after core validation. Unsupported features and preservation limitations are returned by core.

Features

Word inspection, document creation and supported run text replacement. All document algorithms live in OOXML core. Importing the package does not start stdio.

Limitations

Unsupported operations report errors or core diagnostics. Office parity and lossless export are not established. Updates overwrite the source unless outputPath is supplied.

API

Programmatic integration: createServer({ rootDir }) or registerTools(existingMcpServer, { rootDir }). Importing the package does not start a transport. The OOXML combined MCP calls this same registration function.

This package ships JavaScript source and needs no separate build step.

Package releases use npm trusted publishing with provenance.

Documentation

Source and tools | Core automation

License

Apache-2.0.