MCP Office Word — Claude Code MCP server
A local MCP server for assembling Word files from templates, handling tracked changes, and checking document structure. It runs through uvx.
claude mcp add --env WORD_ALLOWLIST_ROOTS=<WORD_ALLOWLIST_ROOTS> --env WORD_ENABLE_WRITE=<WORD_ENABLE_WRITE> --env WORD_ENABLE_COM=<WORD_ENABLE_COM> --transport stdio mcp-office-word -- uvx mcp-officeWhat MCP Office Word does
MCP Office Word gives an agent tools for template-based Word document assembly, tracked-change workflows, and structural checks. The package exposes 50 tools. It runs as a local Python MCP process over stdio, so the client can call Word operations directly.
Use Windows 10 or 11 with Python 3.11 or newer. Microsoft Office is needed for COM-dependent work such as tracked changes; read-only .docx handling works without Office. Set WORD_ALLOWLIST_ROOTS to the permitted file directory, then use WORD_ENABLE_WRITE and WORD_ENABLE_COM for the related capabilities. COM-based Word work will not run outside Windows.
What it helps with
- assemble a Word file from a template
- apply and inspect tracked changes
- check the structure of a
.docxfile - connect Word document work to an MCP client
Example prompts for the agent
- Assemble a Word document from
contract.docxusing the data inclient.json. - Inspect
report.docxand list structural issues. - Apply the requested changes to
draft.docxand save the result in the allowed folder.
How to install MCP Office Word
Platform CLI
claude mcp add --env WORD_ALLOWLIST_ROOTS=<WORD_ALLOWLIST_ROOTS> --env WORD_ENABLE_WRITE=<WORD_ENABLE_WRITE> --env WORD_ENABLE_COM=<WORD_ENABLE_COM> --transport stdio mcp-office-word -- uvx mcp-officeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-office <command>
Platform CLI
codex mcp add mcp-office-word --env WORD_ALLOWLIST_ROOTS=<WORD_ALLOWLIST_ROOTS> --env WORD_ENABLE_WRITE=<WORD_ENABLE_WRITE> --env WORD_ENABLE_COM=<WORD_ENABLE_COM> -- uvx mcp-officeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-office <command>
Config file
{
"mcpServers": {
"mcp-office-word": {
"command": "uvx",
"args": [
"mcp-office"
],
"env": {
"WORD_ALLOWLIST_ROOTS": "<WORD_ALLOWLIST_ROOTS>",
"WORD_ENABLE_WRITE": "<WORD_ENABLE_WRITE>",
"WORD_ENABLE_COM": "<WORD_ENABLE_COM>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-office <command>
Config file
{
"servers": {
"mcp-office-word": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-office"
],
"env": {
"WORD_ALLOWLIST_ROOTS": "<WORD_ALLOWLIST_ROOTS>",
"WORD_ENABLE_WRITE": "<WORD_ENABLE_WRITE>",
"WORD_ENABLE_COM": "<WORD_ENABLE_COM>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-office <command>
Platform CLI
gemini mcp add -e WORD_ALLOWLIST_ROOTS=<WORD_ALLOWLIST_ROOTS> -e WORD_ENABLE_WRITE=<WORD_ENABLE_WRITE> -e WORD_ENABLE_COM=<WORD_ENABLE_COM> mcp-office-word uvx mcp-officeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-office <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MCP Office Word
How do I install MCP Office Word in Claude Code?
Run claude mcp add mcp-office-word -e WORD_ALLOWLIST_ROOTS=<WORD_ALLOWLIST_ROOTS> -- uvx mcp-office. The variable points the server to the permitted Word-file directory.
What does MCP Office Word do?
It exposes 50 tools for assembling Word documents from templates, handling tracked changes, and checking document structure.
Do I need Microsoft Office to use MCP Office Word?
Office is required for COM-dependent operations such as tracked changes. Read-only .docx processing works without an Office installation.
