HWP to Markdown
Turns Korean HWP and HWPX documents into Markdown and JSON tables for AI agents
- 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-hwpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-hwp": {
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-hwp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-hwp": {
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-hwp"
]
}
}
}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

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents
Invoices
MCP serverMCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files
- 4 tools
- Remote
- Paid
- Files and documents

SigPen
MCP serverMCP server that drafts e-signature documents while you approve every send
Not checked yet- 13 tools
- Remote
- Freemium
- Files and documents

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media

WhoScribe
MCP serverSearch and read your WhoScribe audio and video transcripts from ChatGPT, read-only
Not checked yet- Remote
- Freemium
- Design and media