# HWP to Markdown

> HWP to Markdown is an open-source MCP server for files and documents. Turns Korean HWP and HWPX documents into Markdown and JSON tables for AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://appmonster.co.kr
- **Repository:** https://github.com/groove79/kmcp/tree/HEAD/packages/hwp
- **MCP Registry name:** io.github.groove79/mcp-hwp
- **Categories:** files and documents
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/hwp-to-markdown
