Microsoft Word Automation Setup with Claude

• In Claude chat, paste:

Install the latest stable Python version, uvx, and pip packages.

• Run the command. Claude checks and updates dependencies automatically.

Check if Python is Already Installed

• In the Terminal or Command Line, run:

python3 --version

• If you see a message with version 3.10 or later, you can move to the next installation step;
• But if you see an error message or a version earlier than 3.10, follow these instructions.

Method 1: Direct Download

• Visit download page;
• Download Python 3.10 or newer for your operating system;
• Run the installer and ensure "Add Python to PATH" is checked;
• Verify installation with python --version.

Method 2: Command Line Installation

In the Terminal or Command line, run:

• Mac with Homebrew:

brew install python

• Windows:

winget install Python.Python.3.12

• Ubuntu/Debian:

sudo apt update && sudo apt install python3

For users seeking quick setup, Smithery provides automated installation.

• In Claude Desktop, open a chat.
• Copy the prompt:

run npx -y @smithery/cli install @GongRzhe/Office-Word-MCP-Server --client claude

• Paste and run prompt;
• Open Claude's config file → confirm a new block for Microsoft Word MCP has been added;
• Fully exit Claude (Mac: Cmd + Q, Windows: Alt + F4). Restart Claude;
• If issues appear, proceed with Basic Installation.

1. Clone the Repository

• Copy the prompt and paste into Claude:

Clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
into the Documents/projects

• Run the prompt. Claude clones the repo.

2. Install Requirements

• Copy the prompt and paste into Claude:

Install requirements

• Execute. Claude installs necessary dependencies.

3. Update Config

• In Claude, copy and paste:

Remove the previous Office Word MCP block and put this instead
{
  "mcpServers": {
    "word-document-server": {
      "command": "python3",
      "args": ["/path/to/word_mcp_server.py"]
    }
  }
}

• Execute prompt;
• Check config file → old block removed, new block added.

4. Restart Claude

• Fully exit Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Restart Claude.

For users seeking quick setup, Smithery provides automated installation:

npx -y @smithery/cli install @GongRzhe/Office-Word-MCP-Server --client claude

Restart Claude

• Fully exit Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Restart Claude.

When automatic installation encounters issues or for users requiring complete configuration control, manual setup ensures reliable deployment.

Repository Cloning

• In Terminal or Command line navigate to the directory with the MCP servers

cd Documents/projects

• Clone GitHub repo with Office Word MCP Server

git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git

• Enter this directory

cd Office-Word-MCP-Server

• Installs all required Python libraries and dependencies

pip install -r requirements.txt

• Start an agent configuration

python3 setup_ai_agent.py

• Choose the first suggested configuration path when prompted. The system will confirm successful integration with Claude Desktop's configuration file;
• After installation, complete Claude Desktop restart is required for proper agent recognition.

If the agent doesn't appear in Search & Tools:

• Access configuration: use Command+, (Mac) or Ctrl+, (Windows) to open Settings;
• Developer panel: navigate to Developer panel and select "Edit Config";
• Parameter integration: copy configuration parameters:

    "word-document-server": {
      "command": "python3",
      "args": ["/path/to/word_mcp_server.py"]
    }

• Path configuration: use pwd command in Terminal to obtain absolute directory path;
• File management: insert path before configuration closing brackets and save with Command+S or Ctrl+S;
• Complete Claude Desktop restart is required for proper agent recognition;
• Verify the Word AI agent appears in Search & Tools. For optimal testing, temporarily disable other agents like Desktop Commander to isolate functionality.