HWP to Markdown

io.github.groove79Published by GitHub account groove79v0.1.1Updated Oct 29, 2026

Convert Korean HWP/HWPX (한글) documents to Markdown and extract tables. No keys needed.

VerifiedSTDIODesktop onlyFiles & StorageData & Analytics

Overview

AI-generated overview

Local MCP server that converts Korean HWP/HWPX (한글) documents to Markdown and extracts their tables so an assistant can read them.

What you can do
  • Convert an HWP or HWPX document to Markdown, including paragraphs, outline headings and tables
  • Extract every table from a document as JSON row/column arrays for further computation
  • Inspect a file's format, version, title, section/paragraph/table/image counts and encryption or distribution-copy flags
  • Accept the document as a local path, a URL or base64 content
When to use it
Useful when an assistant needs to read Korean-language office documents such as government notices, contracts, bid documents or memos, or pull tables like item lists, quotes and schedules into structured data.
Requirements
Runs as a local stdio process, typically launched with npx from the npm package; Node.js is needed. No API keys, accounts or environment variables are declared. The document must be supplied as a path, URL or base64 content.
Before you install
All tools are described as read-only, and the README says files are processed locally without an external service. Password-protected and distribution copies are rejected with an error, and HWP 3.x is unsupported. Images are counted but not extracted.

Installation

In SourceWeft

  1. Open HWP to Markdown in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@appmonster/mcp-hwp

MCP server that turns HWP / HWPX (한글) documents into Markdown so AI agents can finally read Korean government notices, contracts, bid documents and office memos. Pure TypeScript, no 한글 installation, no external service — the file never leaves your machine.

한글 문서를 마크다운으로. 공문·계약서·입찰서류를 에이전트가 읽게 합니다.

Install

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

No keys, no setup. Also works as a CLI: npx @appmonster/mcp-hwp 공문.hwp > 공문.md.

Tools (all read-only)

ToolWhat it does
hwp_to_markdownParagraphs, outline headings (개요 1~7 → #…), tables → Markdown. Input: path | url | base64
hwp_extract_tablesEvery table as JSON string[][] — for 물품내역, 견적, 일정표
hwp_infoFormat, version, title, counts, encryption / 배포용 flags — without the full text

What is supported

HWP 5.x (binary)HWPX (OWPML)
Body text, line breaks, tabs✓✓
Headings from 개요/제목 styles✓✓
Tables incl. row/col spans✓✓
Title / author metadatabest effort✓
Imagescounted, not extractedcounted, not extracted
Password-protectedclear error—
배포용 (distribution) copiesclear error—
HWP 3.x (1990s format)not supported — re-save as HWP 5/HWPX

Example prompts

  • "이 공문 요약해줘" (파일 첨부 또는 경로)
  • "입찰 서류의 물품 내역 표를 엑셀로 옮길 수 있게 JSON으로 뽑아줘"
  • "https://…/안내문.hwpx 읽고 마감일이 언제인지 알려줘"

MIT © Appmonster

Source: packages/hwp/README.md at commit 2f1998f

Tools

3

hwp_to_markdown

Convert a Korean HWP or HWPX (한글) document to Markdown: paragraphs, outline headings, tables. Pass exactly one of path | url | base64. 한글 문서를 마크다운으로 변환합니다. Use whenever a user gives you a .hwp/.hwpx file or link (공문, 계약서, 입찰서류). Needs the file location.

Parametersurlpathbase64maxChars

hwp_extract_tables

Extract all tables from an HWP/HWPX document as JSON arrays (rows × columns of cell text). 한글 문서의 표를 JSON 배열로 추출합니다. Use for 물품내역, 견적, 일정표 — anything you will compute on. Needs the file location.

Parametersurlpathbase64

hwp_info

Quick facts about an HWP/HWPX file without the full text: format, version, title, section/paragraph/table/image counts, whether it is encrypted or a 배포용 copy. 변환 전에 문서 정보를 확인합니다. Needs the file location.

Parametersurlpathbase64

Version history

2
  1. v0.1.1LatestOct 23, 2026
  2. v0.1.0Oct 21, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts