M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
A

Adeu

Official
Safe Word track changes for LLM editing.
How to install ↓ Compare GitHub source repository ↗
Category
Filesystem #14 of 24
Stars
★ 168 Very popular
Transport
stdio (local process)
Runtime
Node.js · Python
Credentials
No credential needed
License
MIT
Last commit
Tools
3
55FMRS · C

The supplied materials identify Adeu as the official DOCX redlining MCP server maintained by the Adeu team. It uses stdio transport and offers a Node.js npm package plus a Python backend. Its main function is converting validated LLM text edits into native Word Track Changes while preserving document structure; file access, LLM data handling, and human review remain important operational responsibilities.

Strongest · Setup experience 14/20 Weakest · Reliability 7/20

Reliability
7/20
Security and permissions
9/20
Maintenance
12/20
Documentation
13/20
Setup experience
14/20
Why each score
Reliability 7/20
The manifest declares only an npm package using stdio and does not list tool definitions. The README names tools such as read_docx, process_document_batch, and finalize_document, but the supplied material cannot verify their implementation, initialization handshake, tool listing, or error behavior. Multiple invocation paths are documented, but no committed test contents or CI workflow evidence is provided, so the happy path is plausible while unverifiability and missing edge-case evidence require a conservative deduction.
Security and permissions 9/20
The README claims that the core engine and local file tools run locally by default and that local documents are not phoned home; it also discloses that the selected LLM provider processes text read by the agent. The material does not show credential handling, permission scope, path isolation, confirmation for dangerous operations, network controls, or auditing. The tools can modify DOCX files, process comments and tracked changes, and lock documents. No listed red-line risk is established, but incomplete data-boundary and side-effect controls warrant a deduction.
Maintenance 12/20
The repository is not archived, identifies a maintainer team, has an MIT license, reports version 1.30.0, and displays a CI badge. The README also presents Python, Node.js, and several integration entry points, indicating maintenance activity. The supplied material lacks commit history, release dates, dependency-update policy, a vulnerability-response channel, and reviewable CI contents; zero open issues is only a limited signal and does not establish sustained responsiveness, so full marks are not justified.
Documentation 13/20
The README covers the project purpose, installation methods, several MCP client configurations, agent workflows, Python and TypeScript SDKs, CLI usage, platform distinctions, and data-processing claims, with examples. Tool parameters, failure modes, compatibility limits, authentication, cost, troubleshooting, and the actual contents of linked documentation are incomplete. Several capabilities are asserted only by the README, without source evidence, so points are deducted.
Setup experience 14/20
The project provides npx, uvx, Claude Desktop extension, Gemini CLI, Smithery, and generic MCP JSON configuration paths, including a separate Python route for Windows Live Word integration. Mainstream setup is reasonably clear, but it requires Node.js/uvx or a compatible client, Live Word has additional platform dependencies, and no end-to-end connection test is verifiable from the supplied material. The score remains conservative under the static-review ceiling.

Static review · not runListed 2026-07-30

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local files

Best for

  • Legal-tech teams that need Word Track Changes and existing formatting preserved
  • AI-agent workflows operating on local DOCX files
  • Developers integrating document processing through the Python or TypeScript SDKs

Not for

  • Simple DOCX generation from scratch
  • Plain-text editing where Word redlining and XML preservation are unnecessary
  • Users seeking Adeu Cloud email-fetching features without connecting to Adeu Cloud

Required permissions

  • Read access to user-selected DOCX files
  • Write access to save edited or finalized documents
  • Windows, Microsoft Word, and the Python backend for live Word integration
  • The selected LLM provider may process document text read by the agent

Risks and side effects

  • Broad or ambiguous matches can produce unintended edits; the engine blocks ambiguous matches and invalid structural changes
  • AI-generated edits may still conflict with legal or business intent and require human review
  • Document contents are processed by the chosen LLM provider, so sensitive files require policy review
  • Finalization can change metadata and editing protection, so the target file should be confirmed first

Setup

Before you start

Runtime：Node.js · Python

For the Node.js MCP backend, add the supplied configuration to an MCP-capable client and run npx -y @adeu/mcp-server. The Python backend can be run with uvx --from adeu adeu-server; the Python backend is required for live Microsoft Word integration on Windows. Gemini CLI supports gemini extensions install https://github.com/dealfluence/adeu. Claude Desktop can also install the Adeu.mcpb extension from GitHub Releases.

claude_desktop_config.json 
{"mcpServers":{"adeu":{"command":"npx","args":["-y","@adeu/mcp-server"]}}}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "adeu": {
      "command": "npx",
      "args": [
        "-y",
        "@adeu/mcp-server"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add adeu -- npx -y @adeu/mcp-server

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After connecting, confirm that read_docx, process_document_batch, and finalize_document appear in the client's tool list, then ask the agent to read a .docx file to verify the Markdown projection renders.

Troubleshooting

  1. Confirm that the MCP client uses stdio configuration and that npx or uvx is available
  2. Use @adeu/mcp-server for Node.js; use the Python adeu-server backend for live Word integration on Windows
  3. If an edit is not applied, check that the target text is unique and the structural change is valid; ambiguous matches are blocked
  4. Verify that the relevant client extension or plugin is installed and that the DOCX path is correct
  5. Before distribution, verify finalize_document metadata scrubbing and protection-mode settings

Things to try

Once connected, you can ask your AI assistant things like:

  • Read contract.docx and summarize all the defined terms.
  • Replace every occurrence of 'State of New York' with 'State of Delaware' and add a comment explaining the change.
  • Reject the existing tracked change on clause 3 and reply to the author's comment with the reason.
  • Scrub author metadata and internal tracking IDs, then lock the document as read-only before sending it out.

Tools 3

read_docx read-only
Reads a DOCX document and returns an LLM-friendly clean-text or CriticMarkup view, with search and page filters.
process_document_batch writes
Validates and applies a batch of text modifications, or accepts, rejects, and replies to existing tracked changes and comments by ID.
finalize_document destructive
Removes document metadata, author names, and internal tracking IDs; it can also lock the document as read-only for distribution.

Use cases

AI review and redlining of contracts and legal documents
Extracting DOCX text to Markdown for RAG or prompting
Applying batches of tracked text changes
Generating visual diffs between DOCX versions
Scrubbing metadata before distribution

Supported clients

Claude Desktop
Gemini CLI
Claude Code
Cursor
Windsurf
VS Code

Listed from the project's documentation, not tested by this site.

Overview

Adeu is an MCP server that translates DOCX documents to and from LLM-friendly Markdown and CriticMarkup. It validates text edits before applying them as native Word Track Changes while preserving existing formatting, layouts, complex XML, and comments as described in the source material. It provides Python and Node.js implementations and is licensed under MIT.

Similar servers

Compare with other MCP servers

Source revision 557eb3f924e3 Data synced 2026-10-19 Read the FMRS scoring method