Adeu logo

Adeu

Edits DOCX files through MCP, preserving formatting while reading Markdown-style text and writing tracked changes.

Install Adeu

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "adeu": {
      "command": "npx",
      "args": [
        "-y",
        "@adeu/mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 6 tools correctly ().

Overview

The adeu MCP server connects AI agents to DOCX documents, translating Word content into readable text and writing edits back as native tracked changes. Its tools support document reading, revision diffs, batch edits, comment and change handling, and finalization for distribution. Use it for contract review, redlining, form filling, or document workflows where preserving Word structure matters. Python and Node.js server implementations are available, with Python required for live Microsoft Word integration on Windows.

Use cases

  • Review contracts with tracked changes
  • Apply validated edits to DOCX files
  • Compare document versions before editing
  • Fill Word content-control fields
  • Finalize reviewed documents for distribution

Key features

  • Reads DOCX text, outlines, changes, comments, and fields
  • Writes edits as native Word tracked changes
  • Processes sequential batches with salvage or all-or-nothing modes
  • Compares DOCX files with token-level Word Patch diffs
  • Accepts changes and removes review comments
  • Finalizes documents with read-only protection fallback

Tools6

What Adeu lets your agent do. Expand a tool for its parameters.

Verified live~4.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

30/30 checks healthy over the last 99d

What it can do

From the 6 tools this server returned when we ran it.

Can delete or modify data · 2Handles credentials · 3Makes network requests · 1Read-only tools · 4
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age183 days
Maintainers1

Observed 2026-11-10 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · @adeu/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars170Stargazers on the source repository.
npm downloads5.7kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.
Directory activity15 viewsConfig copies, upvotes, and views on AllMCPs.

How Adeu works

What adeu MCP server does

The adeu MCP server provides an MCP interface for reading and modifying Microsoft Word .docx files. It projects document content into an LLM-readable representation and converts approved edits back into DOCX tracked changes. This lets an agent work with document text without directly manipulating WordprocessingML.

The server is intended for review and editing workflows where the original document structure, formatting, comments, and revision history matter. It can read clean text or expose tracked changes and comments through CriticMarkup. It also supports document finalization, comparison of two files, content-control fields, and table-row operations.

How it works

Use read_docx to inspect a document. The tool supports full text, heading outlines, appendices, tracked-change and comment ledgers, and content-control field listings. Full reads can be paginated, searched, or requested as a complete clean view. Pages are synthetic chunks for model consumption rather than printed Word pages.

For targeted edits, process_document_batch applies a sequence of modifications and review actions. Modify operations can replace uniquely matched text, use first or all matches, apply regular expressions, add comments, or insert Markdown-style headings and emphasis. Other operations accept or reject tracked changes, reply to comments, fill fields, and add or remove table rows. Batch processing can salvage valid changes when others fail, or run in all-or-nothing mode.

apply_text_revision accepts the complete clean text and computes tracked changes against the existing document. It verifies that the resulting clean text matches the supplied revision and blocks large deletions unless explicitly allowed. diff_docx_files returns a compact token-level Word Patch comparison, while accept_all_changes produces a finalized document with tracked changes accepted.

Setup and configuration

The adeu MCP server can run through either the Node.js package or the Python package. A JSON MCP configuration can use npx -y @adeu/mcp-server for Node.js or uvx --from adeu adeu-server for Python. The Python backend is required for live editing of an active Microsoft Word document on Windows.

Claude Desktop also supports installation through the released Adeu.mcpb extension package. Claude Code can use the published plugin and optionally connect to either MCP backend. Gemini CLI provides an extension installation command, and the repository documents a skills-based installation for compatible agents such as Cursor, Windsurf, and VS Code Copilot.

Tools and capabilities

The adeu MCP server exposes tools for:

  • Reading document text, outlines, appendices, revisions, comments, and fields.
  • Applying validated text revisions and sequential batches of edits.
  • Accepting or rejecting tracked changes and removing comments.
  • Replying to comments and setting content-control field values.
  • Inserting or deleting table rows in disk-based documents.
  • Comparing DOCX files with a compact token-level diff.
  • Finalizing documents for external distribution or e-signature.

Limitations and notes

apply_text_revision requires the entire clean document text, not a paginated fragment or manually inserted CriticMarkup. Large deletion requests are refused by default under the documented thresholds. Change and comment identifiers can shift after document state changes, so read the current ledger before acting on an identifier.

In the zero-dependency environment, finalize_document does not support encrypted protection. Its read-only lock fallback is used instead, and export_pdf and password options are ignored. Existing content-control locks may also prevent field updates unless an applicable override is provided.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Adeu

adeu is an MCP server that connects AI agents to Microsoft Word DOCX files. Its main tools read document text and review metadata, apply validated revisions as tracked changes, process edit batches, compare document versions, accept changes, and finalize documents for distribution while preserving supported document structure.

Install it by configuring either `npx -y @adeu/mcp-server` for Node.js or `uvx --from adeu adeu-server` for Python in your MCP client. Claude Desktop also supports the released `Adeu.mcpb` extension, and Gemini CLI provides a repository extension command.

Yes, adeu works with Cursor through its MCP JSON configuration or the repository’s Agent Skills installation. Configure the Node.js or Python backend as an MCP server; use Python when live Microsoft Word integration on Windows is required.

Yes, adeu applies tracked changes through `apply_text_revision` or `process_document_batch`. The revision tool compares a complete clean-text version with the document, verifies the resulting clean text, and refuses certain major deletions unless explicitly permitted.

Yes, `accept_all_changes` accepts every tracked change and removes comments by default. Pass `remove_comments=false` to keep comments where the review is still active; the response reports deleted comments and their authors.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAdeu AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/adeu?style=directory)](https://allmcps.com/mcp/adeu)
HTML Embed
<a href="https://allmcps.com/mcp/adeu"><img src="https://allmcps.com/api/badge/adeu?style=directory" alt="Adeu on AllMCPs" /></a>