Adeu translates Microsoft Word .docx files into a Markdown representation that a language model can edit, then translates the edits back into native Word tracked changes. It targets redlining workflows such as contract review, where the returned document must keep its original formatting, layout, fonts, and margin comments intact.
A read produces CriticMarkup text plus a semantic appendix of defined terms, cross-references, and likely typos, and can be filtered by search query or page so an agent locates a clause without pulling the whole document. A validation stage then blocks ambiguous text matches and invalid structural changes before they reach the file, and the apply stage writes the accepted edits into the OOXML as Word Track Changes.
The engine reaches agents through several surfaces: Model Context Protocol servers in Python and Node.js, a Claude Code plugin with a bundled agent skill, an Agent Skills package for other skills-compatible agents, a Gemini CLI extension, a Claude Desktop extension package, an n8n community node, and langchain-adeu, an integration package that exposes the document tools to LangChain. On Windows with Microsoft Word installed, the Python server can edit the document that is open in front of you.
For direct use there are Python and TypeScript SDKs and a Python command-line interface covering text extraction, visual diffs between two versions, edit application (including a partial salvage mode), a JSON-Lines daemon, and metadata sanitisation. The redlining engine and local file tools run entirely on your own machine.
Features
- Two-way document projection: .docx becomes token-efficient Markdown for editing, and edits project back to OOXML
- Tracked changes output: text edits are written as native Word Track Changes attributed to a named author
- Validation gate: ambiguous text matches and invalid structural changes are rejected before the file is touched
- Semantic appendix: reads carry defined terms, cross-references, and likely typos alongside the text
- Batch processing: processdocumentbatch applies modify, accept, reject, and reply operations in one call, with match-mode and regex support
- Document finalisation: finalize_document strips metadata, author names, and internal tracking IDs, and can lock the file read-only
- Command-line tools: extract, diff, apply, serve, and sanitize subcommands
- SDKs: a Python redline engine and a pure TypeScript core package
- Agent surfaces: MCP servers, a Claude Code plugin, an Agent Skills package, and a Gemini CLI extension
- Workflow integrations: an n8n community node and a LangChain toolkit
- Interactive read view: the read tool supports the MCP Apps UI protocol and renders a Markdown view in the chat window
- Live Word editing: the Python server can drive an open document on Windows
