L
LuiccianDev/word-mcp
High-performance Model Context Protocol (MCP) server for programmatic Word (.docx) document generation and manipulation.
★ 3·updated 2026-11-18
View on GitHub ↗Link checked 2026-11-17 · HTTP 200 · opens the vendor's own site
After install: how to tell it works
- What you see after install — The command exits 0 and the terminal shows no "command not found" or "permission denied".
- One-line self-check — Run the smallest usage example from that repository's README. If the output matches what the README describes, it is working.
- If that does not work — This project has no troubleshooting notes. Search its issues for "install".
The install command comes from the repository; these checks describe observable results only and do not replace the project's own docs.
- Star count
- 3 ★ · LuiccianDev/word-mcp · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-17 · last seen 2026-11-20 · seen 4× · listed by 1 sources
- Score
- score 103 · 3 ★ · 1 sources · repo
- Install
- see Install & config above
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
LuiccianDev/word-mcp;first catalogued 2026-11-17;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
Word MCP Server
Excerpted from the repository README (abridged)
High-performance Model Context Protocol (MCP) server for programmatic Word (.docx) document generation and manipulation
Word MCP Server (word-mcp, PyPI: luiccian-word-mcp) is a high-performance Python server implementing the Model Context Protocol (MCP) to provide advanced, token-optimized Word document (.docx) creation, batch synthesis, and inspection capabilities for AI assistants (Claude, Cursor, Copilot, Cline).
Designed from the ground up for maximum token efficiency, it replaces chatty micro-iterations with single-pass document construction—saving over 90% of model tokens and conversational turns.
## Key Architectural Highlights
Single-Pass Document Builder: Create complete, publication-ready documents (headers, footers, page numbers, margins, headings, paragraphs with markdown styling, tables, lists) in one single MCP call (build_document).
Markdown Direct Generation: Instantly turn structured markdown text into professionally styled Word documents (create_from_markdown).
Visual Design Presets: Built-in typography and spacing standards (modern, formal, academic, compact).
Lightweight Outline Inspection: Extract paragraph previews and table counts without dumping full body text (get_document_outline), saving context tokens.
Batch Content Ingestion: Append multiple sections, tables, and lists to existing documents in a single atomic operation (batch_add_content).
Protection & Security: Password protection, editing restrictions, file integrity checks, and headless PDF conversion.
Complete Tool Reference: See docs/TOOLS.md for every tool signature, return shape, and limitation.
Zero-Install Execution: Instant launch with uvx luiccian-word-mcp.
## Quick Start with uvx (Recommended)
No manual clone or installation required. You can run the server directly using uv:
bash
# Run with stdio transport (default for AI IDEs)
uvx luiccian-word-mcp
# Or run with SSE transport
uvx luiccian-word-mcp --transport sse --host 127.0.0.1 --port 8000
## MCP Client Configuration
### 1. Claude Desktop
Add this configuration to your claude_desktop_config.json:
json
"mcpServers": {
"word-mcp": {
"command": "uvx",
"args": ["luiccian-word-mcp"],
"env": {
"MCP_ALLOWED_DIRECTORIES": "/path/to/your/documents"
> Tip (Local checkout): If running from a local clone:
> json
> {
> "mcpServers": {
> "word-mcp": {
> "command": "uv",
> "args": ["run", "--directory", "/path/to/word-mcp", "luiccian-word-mcp"],
> "env": {
> "MCP_ALLOWED_DIRECTORIES": "/path/to/your/documents"
> }
> }
> }
> }
### 2. Cursor (.cursor/mcp.json)
json
"mcpServers": {
"word-mcp": {
"command": "uvx",
"args": ["luiccian-word-mcp"],
"env": {
"MCP_ALLOWED_DIRECTORIES": "${workspaceFolder}"
## Local Development with uv
bash
# 1. Clone repository
git clone https://github.com/LuiccianDev/word-mcp.git
cd word-mcp
# 2. Sync virtual environment and dependencies
uv sync --all-groups
# 3. Run server
uv run luiccian-word-mcp
# 4. Run tests, linter, and type checker
uv run pytest
uv run ruff check src tests scripts
uv run mypy src
## CI/CD & PyPI Trusted Publishing
The repository includes automated GitHub Actions workflows powered by Astral uv:
CI (.github/workflows/ci.yml): Runs tests, lint, and type checks across Python 3.11, 3.12, and 3.13 on Ubuntu. Uses paths-ignore and concurrency cancellation to preserve GitHub Actions minutes.
Word MCP Server (word-mcp, PyPI: luiccian-word-mcp) is a high-performance Python server implementing the Model Context Protocol (MCP) to provide advanced, token-optimized Word document (.docx) creation, batch synthesis, and inspection capabilities for AI assistants (Claude, Cursor, Copilot, Cline).
Designed from the ground up for maximum token efficiency, it replaces chatty micro-iterations with single-pass document construction—saving over 90% of model tokens and conversational turns.
## Key Architectural Highlights
Single-Pass Document Builder: Create complete, publication-ready documents (headers, footers, page numbers, margins, headings, paragraphs with markdown styling, tables, lists) in one single MCP call (build_document).
Markdown Direct Generation: Instantly turn structured markdown text into professionally styled Word documents (create_from_markdown).
Visual Design Presets: Built-in typography and spacing standards (modern, formal, academic, compact).
Lightweight Outline Inspection: Extract paragraph previews and table counts without dumping full body text (get_document_outline), saving context tokens.
Batch Content Ingestion: Append multiple sections, tables, and lists to existing documents in a single atomic operation (batch_add_content).
Protection & Security: Password protection, editing restrictions, file integrity checks, and headless PDF conversion.
Complete Tool Reference: See docs/TOOLS.md for every tool signature, return shape, and limitation.
Zero-Install Execution: Instant launch with uvx luiccian-word-mcp.
## Quick Start with uvx (Recommended)
No manual clone or installation required. You can run the server directly using uv:
bash
# Run with stdio transport (default for AI IDEs)
uvx luiccian-word-mcp
# Or run with SSE transport
uvx luiccian-word-mcp --transport sse --host 127.0.0.1 --port 8000
## MCP Client Configuration
### 1. Claude Desktop
Add this configuration to your claude_desktop_config.json:
json
"mcpServers": {
"word-mcp": {
"command": "uvx",
"args": ["luiccian-word-mcp"],
"env": {
"MCP_ALLOWED_DIRECTORIES": "/path/to/your/documents"
> Tip (Local checkout): If running from a local clone:
> json
> {
> "mcpServers": {
> "word-mcp": {
> "command": "uv",
> "args": ["run", "--directory", "/path/to/word-mcp", "luiccian-word-mcp"],
> "env": {
> "MCP_ALLOWED_DIRECTORIES": "/path/to/your/documents"
> }
> }
> }
> }
### 2. Cursor (.cursor/mcp.json)
json
"mcpServers": {
"word-mcp": {
"command": "uvx",
"args": ["luiccian-word-mcp"],
"env": {
"MCP_ALLOWED_DIRECTORIES": "${workspaceFolder}"
## Local Development with uv
bash
# 1. Clone repository
git clone https://github.com/LuiccianDev/word-mcp.git
cd word-mcp
# 2. Sync virtual environment and dependencies
uv sync --all-groups
# 3. Run server
uv run luiccian-word-mcp
# 4. Run tests, linter, and type checker
uv run pytest
uv run ruff check src tests scripts
uv run mypy src
## CI/CD & PyPI Trusted Publishing
The repository includes automated GitHub Actions workflows powered by Astral uv:
CI (.github/workflows/ci.yml): Runs tests, lint, and type checks across Python 3.11, 3.12, and 3.13 on Ubuntu. Uses paths-ignore and concurrency cancellation to preserve GitHub Actions minutes.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/luicciandev-word-mcp/)
- Source
- github · https://github.com/LuiccianDev/word-mcp
- Browse by field
- Open source
- Traction
- 3 ★
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.