Adeu MCP
Adeu: an MCP server, skill and CLI for editing .docx through an agent with real Track Changes, comments and version diffs.
- 170 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The server reads and modifies .docx files the agent points to.
- `finalize_document` irreversibly strips metadata from the document.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/adeuDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server reads and modifies .docx files the agent points to.
- `finalize_document` irreversibly strips metadata from the document.
This is third-party code. Review the repository files before installing.
What it does
Adeu turns a Word document into model-friendly Markdown with CriticMarkup and a semantic appendix (defined terms, cross-references, likely typos), and writes the agent edits back into OOXML as real tracked changes. Formatting, fonts and margin comments are preserved. Each change passes validation: ambiguous matches and invalid structural edits are blocked before touching the file. Tools: `read_docx` (changes, fields and outline modes, search over text and pages), `process_document_batch` (a batch of edits: text replacement, form fields, accept, reject or reply to markup, table row insert and delete, comments), `diff_docx_files` (compare two files into a tracked-changes document) and `finalize_document` (before sending, strips metadata, author names and internal IDs and locks the document read-only). There are Python and Node.js implementations, a Claude Code plugin with a skill, a Gemini CLI extension and an `.mcpb` package for Claude Desktop. On Windows the Python server can edit a document open in live Word.
Who it is for. Lawyers, editors and teams who negotiate contracts and texts in Word and want an agent to edit a document in review mode.
Good fit when
- The agent makes contract edits as Track Changes and the file stays the same one.
- Reviews others fixes and comments, accepts some and replies to others.
- Compares two contract versions and gets a document with tracked differences.
- Before sending to a counterparty, strips metadata and author names and locks the document.
Not a fit when
- A document has to be created from scratch: python-docx and similar libraries do that.
- The file is in another format: Adeu works with .docx.
- Editing a live Word document on macOS is needed: the live Word mode is Windows only with the Python server.
Example request
Read contract.docx through Adeu, make edits to clause 4.2 as tracked changes and add a comment for the counterparty.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
Works with .docx files, integration with a document open in Word needs Windows, Word installed and the Python server. In agent edits an ambiguous match is rejected, so text to replace must be specified unambiguously. `finalize_document` irreversibly strips metadata, so keep a working copy first. The `markup_mode="manual"` mode fits when formatted markup is needed instead of Track Changes.
How to disable. Remove the adeu entry from the client config, for the Claude Code plugin run `/plugin uninstall adeu-redlining@adeu-skills`, and the Gemini CLI extension is removed with its own command.
FAQ
How do I install Adeu in Claude Code?
With `/plugin marketplace add dealfluence/adeu` and `/plugin install adeu-redlining@adeu-skills`, and for best results also connect the MCP server `npx -y @adeu/mcp-server`.
How do I install the skill for Cursor or Windsurf?
With `npx skills add dealfluence/adeu`, the skill follows the open Agent Skills specification.
How do Node.js and Python differ?
The functions are the same, but only the Python server drives live Word on Windows.
What does finalize_document do?
Strips metadata, author names and internal IDs and locks the document read-only before sending.
Is there an SDK for code?
Yes, for Python and TypeScript, and a Python CLI for local use.
Discussion
No questions or reviews yet.
Related
MCP serversMCP Word server for docx editing with tracked changes: comments, footnotes, version comparison and a change log, all visible in Word
A skill plus the docx program: the agent fills forms, edits tables and reviews Word files with tracked changes
The Word to Markdown MCP server: an agent turns a .docx file into clean Markdown locally, with images, tables and footnotes.
Word MCP Live
word-mcp-live
An MCP server for Microsoft Word: the agent edits an open document live, with tracked changes, comments and action rollback
Doc-Ops MCP converts DOCX, Markdown, HTML and PDF between formats and stamps a watermark or QR code onto finished PDFs.
Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Adeu (this card) | yes | not required | 170 | |
| Safe DOCX | no | not required | 47 | another MCP for editing Word; Adeu has the CriticMarkup scheme, edit validation and a live Word mode on Windows |
| docx-mcp | no | not required | 69 | another MCP for DOCX; Adeu writes changes as Track Changes preserving OOXML and compares versions |
README in short
The README presents Adeu as a translator between Word and a model: reading into CriticMarkup, validating edits and writing as Track Changes. Then installation (Claude Code plugin, skill, Claude Desktop, Gemini CLI, MCP clients), the tools and a recommended prompt, live Word mode and SDKs for Python and TypeScript.