Skip to content
MCP server

HWP to Markdown

Turns Korean HWP and HWPX documents into Markdown and JSON tables for AI agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.1
Listing updated
2 days ago

About HWP to Markdown

HWP to Markdown is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Korean government notices, contracts and bid documents are often saved as HWP or HWPX files that general-purpose tools cannot open. This server reads them in pure TypeScript, so Hangul word-processor software is not needed and the file is never sent to an outside service.

It converts paragraphs, outline headings and tables to Markdown, and can return every table as a JSON array of rows, which suits item lists, quotes and schedules. A third tool reports format, version, title, counts and whether the file is encrypted or a distribution copy, without returning the full text.

Input can be a local path, a URL or base64 data. Images are counted but not extracted, password-protected files and distribution copies return a clear error, and the old HWP 3.x format is not supported. It also runs as a command-line converter.

Install

Run in a terminal

claude mcp add mcp-hwp -- npx -y @appmonster/mcp-hwp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-hwp": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-hwp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-hwp": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-hwp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-hwp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-hwp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-hwp": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-hwp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-hwp": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-hwp"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

hwp_to_markdown
Converts paragraphs, outline headings and tables to Markdown from a path, URL or base64 input.
hwp_extract_tables
Returns every table as JSON string arrays.
hwp_info
Reports format, version, title, counts and encryption or distribution flags without the full text.

What it does

Document to Markdown
Converts paragraphs, outline headings and tables from HWP 5.x and HWPX files into Markdown.
Table extraction
Returns each table as JSON rows, including tables with merged rows and columns.
File inspection
Reports format, version, title, counts and encryption flags without returning the text.
Three input types
Accepts a file path, a URL or base64 content.
Runs locally
Written in TypeScript with no Hangul software or external service, so files stay on your machine.
Command-line mode
The same converter can be run with npx to write a Markdown file.

Good for

  • Summarise a Korean official notice
  • Pull the item list from a procurement or bid document as JSON
  • Check contract text for deadlines
  • Read a HWPX file linked online
  • Inspect whether an HWP file is encrypted before processing

Pricing

Open source

MIT licence; no keys needed

Prices change. Check appmonster.co.kr before you buy.

HWP to Markdown FAQ

Do I need Hangul installed?

No. The README says it is pure TypeScript with no 한글 installation and no external service.

Does it need an API key?

No keys or setup are required; add it to an MCP client with npx.

Which formats work?

HWP 5.x and HWPX. HWP 3.x files must be re-saved as HWP 5 or HWPX.

What happens with protected files?

Password-protected HWP files and distribution (배포용) copies return a clear error.

Is HWP to Markdown free?

Yes. HWP to Markdown is open source, so you can use and self-host it for free.

How do I add HWP to Markdown to Claude Code?

Run this command in your terminal: claude mcp add mcp-hwp -- npx -y @appmonster/mcp-hwp

What are the best alternatives to HWP to Markdown?

The closest alternatives to HWP to Markdown are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to HWP to Markdown

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media