reformat-mcp

MCP server for Reformat — format Word documents (.docx) with professional templates. Applies styles, numbering, punctuation, and structure using your organization's templates.

Works with Claude Desktop, claude.ai, and any MCP-compatible client.

Setup

1. Get your API key

Sign up at Reformat and grab your API key from the dashboard web.reformatword.com/api-keys.

2. Add the MCP server

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "reformat": {
      "command": "npx",
      "args": ["-y", "reformat-mcp"],
      "env": {
        "REFORMAT_API_KEY": "<your-api-key>"
      }
    }
  }
}

claude.ai (web)

Go to Settings > MCP Servers and add:

{
  "command": "npx",
  "args": ["-y", "reformat-mcp"],
  "env": {
    "REFORMAT_API_KEY": "<your-api-key>"
  }
}

Environment variables

| Variable | Required | Description | |---|---|---| | REFORMAT_API_KEY | Yes | Your Reformat API key | | REFORMAT_API_URL | No | API endpoint (defaults to https://web.reformatword.com) |

Usage

/reformat prompt

Type /reformat in Claude to start the guided workflow. It walks you through template selection, formatting, review, and corrections.

Tools

All tools are available directly in conversation:

| Tool | Cost | Description | |---|---|---| | reformat_list_templates | Free | List available templates for your organization | | reformat_get_template | Free | Get full style and numbering definitions for a template | | reformat_check_credits | Free | Check your available formatting credits | | reformat_analyze_document | Free | Preview what formatting would do without modifying the file | | reformat_format_document | 1 credit | Submit a .docx file for formatting and get jobId, decryptionKey, templateId, and exact next-check args | | reformat_check_job | Free | Check one submitted formatting job, save the output file when ready, and return exact next-step args | | reformat_inspect_paragraphs | Free | Compare before/after formatting for specific paragraphs | | reformat_apply_corrections | Free | Fix misclassified paragraph styles in the formatted output |

Typical workflow

1. Choose a template — reformat_list_templates then reformat_get_template
2. Submit — reformat_check_credits then reformat_format_document
3. Check — call reformat_check_job until status is completed
4. Review — reformat_inspect_paragraphs to verify results
5. Correct — reformat_apply_corrections if anything was misclassified
6. Done — the formatted file is saved alongside the original with a [Reformat] prefix

reformat_check_job now returns a structured nextAction field:

• check_job while processing, with exact args to reuse on the next poll
• inspect when formatting completes, with exact args for reformat_inspect_paragraphs
• stop when formatting fails

Known issues

• /reformat prompt not available in Cowork mode — The tools work, but the prompt doesn't surface as a slash command. Use natural language instead (e.g., "format this document with Reformat"). The tool outputs now carry the required follow-up workflow directly.
• Uploaded files not accessible in Claude Desktop chat — Files dragged into the chat go to a sandboxed path the MCP server can't reach. Use absolute file paths instead (e.g., /Users/name/Desktop/document.docx). Works correctly in Cowork mode.

Development

git clone https://github.com/Cleveland-RD/reformat-mcp.git
cd reformat-mcp
npm install
npm run dev

npm run dev uses tsx to run TypeScript directly. npm run build compiles to dist/.

License

MIT