docx.sh — DOCX to HTML

Add docx.sh as a remote MCP server in Claude Code with --transport http. See the Claude Code MCP docs for scopes, OAuth, and troubleshooting.

CLI one-liner

Run from your project root.

export DOCXTOHTML_API_TOKEN=XXXXXXYOUR_TOKENXXXXXX
claude mcp add --scope project --transport http docxtohtml https://docx.sh/mcp \
  --header 'Authorization: Bearer ${DOCXTOHTML_API_TOKEN}'

Project MCP config

If you prefer not to use the CLI one-liner above, paste this into .mcp.json instead. Includes your token — treat this file like a secret.

{
  "mcpServers": {
    "docxtohtml": {
      "type": "http",
      "url": "https://docx.sh/mcp",
      "headers": {
        "Authorization": "Bearer XXXXXXYOUR_TOKENXXXXXX"
      }
    }
  }
}

Paste into project MCP settings so Cursor can call docx.sh tools.

Config file: .cursor/mcp.json
MCP endpoint: https://docx.sh/mcp

MCP config

Includes your token — treat this file like a secret.

{
  "mcpServers": {
    "docxtohtml": {
      "url": "https://docx.sh/mcp",
      "headers": {
        "Authorization": "Bearer XXXXXXYOUR_TOKENXXXXXX"
      }
    }
  }
}

Add a remote MCP server in Codex, then point it at your token via an env var.

Config file: .codex/config.toml
Env var: DOCXTOHTML_API_TOKEN=<token>

MCP server block

Codex reads the token from DOCXTOHTML_API_TOKEN — don't hardcode it in the TOML.

[mcp_servers.docxtohtml]
url = "https://docx.sh/mcp"
bearer_token_env_var = "DOCXTOHTML_API_TOKEN"

Call the HTTP API directly from scripts, CI, or your backend.

Base URL: https://docx.sh/api/v1
Auth header: Authorization: Bearer <token>

Example upload

Creates a document from a local DOCX file.

curl -X POST "https://docx.sh/api/v1/documents" \
  -H "Authorization: Bearer XXXXXXYOUR_TOKENXXXXXX" \
  -F "file=@document.docx"

Agent Setup

How are you connecting?

CLI one-liner

Project MCP config

MCP config

MCP server block

Example upload