WordCraft MCP Server

Why

WordCraft is an open-source, Word-class word processor written in Rust, with a headless CLI (wordcraft-cli), 615 commands, DOCX / ODT / RTF / PDF support and an MCP mode. This Model Context Protocol server turns that engine into file-in / file-out tools for Claude, so you can ask things like:

"Write a 3-page quarterly report with a table of contents, a sales table, this chart and page numbers, as DOCX and PDF." "In contract.docx, change 'ACME Ltd.' to 'ACME S.A.S.' with tracked changes and add a comment on the payment clause." "Create a letter for every customer in customers.xlsx, with their name and city." "Accept all changes in every document in D:\Contracts and export them as PDF." "Convert these Markdown notes to Word, and this Word file to LaTeX."

Sibling of designcraft-mcp-server, effectcraft-mcp-server, lightcraft-mcp-server, photocraft-mcp-server, vectorcraft-mcp-server, filmcraft-mcp-server, pdfcraft-mcp-server and audacity-mcp-server.

Related MCP server: Word Document MCP Server

Platforms

All downloads: WordCraft releases (there is also a FreeBSD tar.gz; set WORDCRAFT_DIR to it). Anywhere else: set WORDCRAFT_DIR (folder, .tar.gz root or WordCraft.app) or WORDCRAFT_CLI.

• macOS: the DMG contains only the app. Unzip the separate wordcraft-cli zip and move wordcraft-cli to /usr/local/bin (or point WORDCRAFT_CLI at it). The first run checks Apple's notarization online.

• Linux: the AppImage and Flatpak contain only the app, not wordcraft-cli; use the deb, rpm or tar.gz. For an AppImage app, set WORDCRAFT_APP so open_in_wordcraft can start it. On a server without a GPU, the verified setup used libxkbcommon0 libvulkan1 libegl1 mesa-vulkan-drivers libasound2 fontconfig.

How it works

Tools

Example

{
  "name": "Quarterly report",
  "template": "blank",
  "page_size": "A4",
  "margins": "normal",
  "header": "ACME S.A.S.",
  "page_numbers": "bottom",
  "title": "Quarterly report 2026",
  "author": "Finance",
  "blocks": [
    { "type": "paragraph", "text": "Quarterly report 2026", "style": "Title" },
    { "type": "toc", "levels": 2 },
    { "type": "heading", "text": "Summary", "level": 1 },
    { "type": "paragraph", "text": "Sales grew 12 % over the last quarter." },
    { "type": "paragraph", "text": "Highlight in bold red.", "bold": true, "color": "#c00000", "align": "center" },
    { "type": "bullets", "items": ["Grow in Colombia", "Open Peru", "Cut costs"] },
    { "type": "heading", "text": "Results", "level": 1 },
    { "type": "table", "caption": "Sales by region", "rows": [["Region", "Sales", "Change"], ["North", "1,200", "+8 %"], ["South", "950", "+15 %"]] },
    { "type": "image", "path": "C:\\Reports\\chart.png", "width": 360, "caption": "Sales by month" },
    { "type": "footnote", "text": "Source: internal data." }
  ],
  "formats": ["docx", "pdf"],
  "output_dir": "C:\\Reports"
}

Requirements

• WordCraft with wordcraft-cli (tested with 0.6.1); see Platforms

• Node.js ≥ 20 (bundled with Claude Desktop for .mcpb installs)

Installation

Claude Desktop (recommended, all platforms)

1. Download wordcraft-mcp-server.mcpb from the latest release.

2. Double-click it (or drag it into Claude Desktop → Settings → Extensions) and click Install.

3. Optional: if WordCraft is not in a standard location, fill in its folder or the wordcraft-cli path in the extension settings.

Sunsam Code

Install WordCraft Bridge from the Sunsam Code marketplace, or drop the .mcpb into MCP → Install extension.

Codex (OpenAI)

Recommended — the marketplace (gets updates): Plugins → Add → Add marketplace, source jhonsu01/craft-marketplace, reference main, then install WordCraft Bridge from Craft Bridges (craft-marketplace). New versions arrive by refreshing the marketplace. Or upload the zip (Codex then keeps it in your account and refuses a newer zip with the same name):

1. Download wordcraft-mcp-server-<version>-codex.zip from the latest release.

2. In Codex: Plugins → Add → New plugin, choose the zip and click Add plugin.

3. Codex starts the server with node, so Node.js ≥ 20 must be on PATH. If WordCraft is not in a standard location, set WORDCRAFT_DIR or WORDCRAFT_CLI as system environment variables (Codex has no settings form for local plugins).

DeepSeek Harness

1. Plugins → Add plugin, enter github:jhonsu01/craft-marketplace#path:/plugins/wordcraft-mcp-server and click Install, then Enable now.

2. Harness runs the server with its own MCP client and node (Node.js ≥ 20 on PATH); the tools appear as mcp__wordcraft__<tool> and the output files as cards that open in Harness.

3. Harness does not update plugins by itself yet: to upgrade, uninstall the plugin and install it again with the same address.

Claude Code / other MCP clients

git clone https://github.com/jhonsu01/wordcraft-mcp-server.git
cd wordcraft-mcp-server
npm install
npm run build

Windows:

claude mcp add wordcraft -- node "%CD%\dist\bundle.cjs"

macOS / Linux:

claude mcp add wordcraft -- node "$PWD/dist/bundle.cjs"

Configuration

Safety

• Files are never overwritten unless overwrite: true: a free name (_2) is used in folders and an existing output_path is an error. Documents, images and data are only read; an edited document is saved only as a new copy (_edited).

• All paths must be absolute. The engine runs headless and never touches the WordCraft app unless live: true.

• Everything runs locally with no network access. Each job uses a private engine in a temporary folder that is deleted at the end.

Development

npm run build       # TypeScript + single-file bundle (dist/bundle.cjs)
npm test            # unit tests (Windows, macOS and Linux path logic)
npm run test:e2e    # 29 end-to-end checks (31 with `E2E_LIVE=1`) over real MCP stdio (synthetic image and CSV)
npm run pack:mcpb   # wordcraft-mcp-server.mcpb
npm run pack:codex  # Codex / DeepSeek Harness plugin zip

Linux test in Docker (unpack wordcraft-<version>-linux-x86_64.tar.gz first):

docker run --rm -v "$PWD:/work:ro" -v "/path/to/wordcraft-0.6.1-linux-x86_64:/opt/wordcraft:ro" -e WORDCRAFT_DIR=/opt/wordcraft -w /work node:22-bookworm bash -c "apt-get update && apt-get install -y libxkbcommon0 libvulkan1 libegl1 mesa-vulkan-drivers libasound2 fontconfig && node scripts/e2e.mjs"

License

Apache-2.0. WordCraft is © its authors (Storytold), MIT or Apache-2.0. This project is not affiliated with or endorsed by WordCraft or Storytold. Word is a trademark of Microsoft.