ooxml-integrity
Finds comments, tracked changes and notes lost when a script or agent edits Word files
- Pricing
- Free
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.10.0
- Listing updated
- today
Similar MCP servers
About ooxml-integrity
ooxml-integrity is a free MCP server for files and documents. It runs locally on your machine and is started by your AI client.
An edited Word file can open without complaint and still be missing a reviewer's comment, another author's tracked change or a footnote. This checker compares an edited .docx against its original and reports what disappeared, along with broken internal references in comments, footnotes, styles, numbering and relationships.
It also looks at .pptx decks and predicts whether text will overflow its shape, using the font metrics read from the file. Everything runs locally: the README says there is no rendering, no model call and no network access. Output is human-readable or JSON, and a non-zero exit code fails a CI job.
A separate fix command makes only three repairs whose result is unambiguous (reply anchors, repeated revision ids, content types) and writes a verified copy instead of touching the input. A flag added in 0.10.0 limits failures to defects the edit introduced, which suits documents that arrive already damaged.
Install
Run in a terminal
claude mcp add ooxml-integrity -- uvx ooxml-integrityAdd to claude_desktop_config.json
{
"mcpServers": {
"ooxml-integrity": {
"command": "uvx",
"args": [
"ooxml-integrity"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ooxml-integrity": {
"command": "uvx",
"args": [
"ooxml-integrity"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ooxml-integrity": {
"type": "stdio",
"command": "uvx",
"args": [
"ooxml-integrity"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ooxml-integrity": {
"command": "uvx",
"args": [
"ooxml-integrity"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ooxml-integrity": {
"command": "uvx",
"args": [
"ooxml-integrity"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Fidelity check against source
- Compares an edited file with the original and counts lost comment anchors, revisions and notes.
- Reference integrity checks
- Finds orphaned comments, bad relationships and other broken links inside a single file.
- Slide text overflow
- Predicts when text will not fit its box in a .pptx using the file's own font data.
- Narrow, verified repairs
- The fix command applies three unambiguous repairs and re-checks the copy before writing it.
- CI action and SARIF
- Runs as a GitHub Action with JSON and SARIF reports and path-scoped ignores.
- Introduced-only mode
- Fails only on defects the edit added, listing pre-existing ones as suppressed.
Good for
- Gate a pipeline that edits contracts with python-docx
- Check what an AI agent changed in a reviewed Word document
- Catch overflowing text in generated slide decks
- Audit a template merge for dropped comments or tracked changes
Pricing
Free
Installed from PyPI; no paid plan mentioned
ooxml-integrity FAQ
Does it send documents anywhere?
No. The README says it runs locally with no rendering, model calls or network.
Will it repair my file?
Only three kinds of damage are repaired, and the original is never changed; a new verified copy is written.
How do I use it in CI?
Run the command after a generation step and use the exit code, or use the project's GitHub Action with JSON or SARIF output.
Which formats does it handle?
Word .docx for comment, revision and note losses, and PowerPoint .pptx for text fit.
Is ooxml-integrity free?
Yes. ooxml-integrity is free to use.
How do I add ooxml-integrity to Claude Code?
Run this command in your terminal: claude mcp add ooxml-integrity -- uvx ooxml-integrity
What are the best alternatives to ooxml-integrity?
The closest alternatives to ooxml-integrity are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


