MS Word

by famano

7 stars

326 downloads

Not rated

GitHub

About

Integrates with Microsoft Word documents to enable reading, writing, and editing of text, tables, and images for automated document processing and content generation.

Details

Author: famano
Repository: famano/mcp-server-office
GitHub stars: 7
Downloads: 326
License: MIT License
Categories: Productivity, Developer Tools, Design, Workplace, File Management, AI, Media, Knowledge Base, Project Management, Automation, Frontend

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name MS Word

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

Install with pip:

pip install mcp-server-office

Then, start the MCP server:

mcp-server-office

Or using uv, just:

uvx mcp-server-office

To install Server Office for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @famano/mcp-server-office --client claude

`read_docx`

Read complete contents of a docx file including tables and images. Parameters: path (string) - Absolute path to the target file.

`write_docx`

Create a new docx file with given content. Parameters: path (string) - Absolute path to target file, content (string) - Content to write to the file.

`edit_docx_paragraph`

Make text replacements in specified paragraphs of a docx file. Parameters: path (string) - Absolute path to file to edit, edits (array) - List of dictionaries containing search/replace text and paragraph index.

`edit_docx_insert`

Insert new paragraphs into a docx file. Parameters: path (string) - Absolute path to file to edit, inserts (array) - List of dictionaries containing text and optional paragraph index.

1. read_docx: Read complete contents of a docx file including tables and images.

- Input: path (string) - Absolute path to the target file
- Note: Images are converted to [Image] placeholders, and track changes are not shown
2. write_docx: Create a new docx file with given content.

- Input:
- path (string) - Absolute path to target file
- content (string) - Content to write to the file
- Note: Use double line breaks for new paragraphs, and [Table] tag with | separators for tables
3. edit_docx_paragraph: Make text replacements in specified paragraphs of a docx file.

- Input:
- path (string) - Absolute path to file to edit
- edits (array) - List of dictionaries containing search/replace text and paragraph index
- paragraph_index (number) - 0-based index of the paragraph to edit
- search (string) - Text to find within the specified paragraph
- replace (string) - Text to replace with
- Note: Each search string must match exactly once within the specified paragraph
4. edit_docx_insert: Insert new paragraphs into a docx file.

- Input:
- path (string) - Absolute path to file to edit
- inserts (array) - List of dictionaries containing text and optional paragraph index
- text (string) - Text to insert as a new paragraph
- paragraph_index (number, optional) - 0-based index of the paragraph before which to insert. If not specified, insert at the end.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ms word": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

MCP Server Office

A Model Context Protocol (MCP) server providing tools to read/write Microsoft Word (docx) files.

Installing via Smithery

To install Server Office for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @famano/mcp-server-office --client claude

Usage

Install with pip:

pip install mcp-server-office

Then, start the MCP server:

mcp-server-office

Or using uv, just:

uvx mcp-server-office

Available Tools

1. read_docx: Read complete contents of a docx file including tables and images.

Requirements

- Python >= 3.12
- Dependencies:
- mcp[cli] >= 1.2.0
- python-docx >= 1.1.2

---

MCP Server Office (日本語)

Microsoft Word (docx) ファイルの読み書きを提供するModel Context Protocol (MCP) サーバーです。

Smitheryによるインストール

Smithery経由でClaude DesktopにServer Officeを自動インストールするには:

npx -y @smithery/cli install @famano/mcp-server-office --client claude

使用方法

pipを使用してインストール:

pip install mcp-server-office

MCPサーバーの起動:

mcp-server-office

または、uvを使う場合:

uvx mcp-server-office

利用可能なツール

1. read_docx: docxファイルの内容を表やイメージを含めて完全に読み取ります。

- 入力: path (文字列) - 対象ファイルの絶対パス
- 注意: 画像は[Image]というプレースホルダーに変換され、変更履歴は表示されません
2. write_docx: 新しいdocxファイルを指定された内容で作成します。

- 入力:
- path (文字列) - 作成するファイルの絶対パス
- content (文字列) - ファイルに書き込む内容
- 注意: 段落は2つの改行で区切り、表は[Table]タグと|区切りを使用します
3. edit_docx_paragraph: docxファイル内の指定された段落のテキストを置換します。

- 入力:
- path (文字列) - 編集するファイルの絶対パス
- edits (配列) - 検索/置換テキストと段落インデックスを含む辞書のリスト
- paragraph_index (数値) - 編集する段落の0ベースのインデックス
- search (文字列) - 指定された段落内で検索するテキスト
- replace (文字列) - 置換するテキスト
- 注意: 各検索文字列は指定された段落内で一度だけマッチする必要があります
4. edit_docx_insert: docxファイルに新しい段落を挿入します。

- 入力:
- path (文字列) - 編集するファイルの絶対パス
- inserts (配列) - テキストとオプションの段落インデックスを含む辞書のリスト
- text (文字列) - 新しい段落として挿入するテキスト
- paragraph_index (数値, オプション) - 挿入する位置の段落の0ベースのインデックス。指定しない場合は末尾に挿入されます。

動作要件

- Python >= 3.12
- 依存パッケージ:
- mcp[cli] >= 1.2.0
- python-docx >= 1.1.2

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

read_docx

write_docx

edit_docx_paragraph

edit_docx_insert

Claude Desktop / Cursor

Linux

Macos

Windows

MCP Server Office

Installing via Smithery

Usage

Available Tools

Requirements

MCP Server Office (日本語)

Smitheryによるインストール

使用方法

利用可能なツール

動作要件

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`read_docx`

`write_docx`

`edit_docx_paragraph`

`edit_docx_insert`