@appmonster/mcp-hwp

@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

{
  "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)

Tool	What it does
hwp_to_markdown	Paragraphs, outline headings (개요 1~7 → #…), tables → Markdown. Input: path | url | base64
hwp_extract_tables	Every table as JSON string[][] — for 물품내역, 견적, 일정표
hwp_info	Format, 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 metadata	best effort	✓
Images	counted, not extracted	counted, not extracted
Password-protected	clear error	—
배포용 (distribution) copies	clear error	—
HWP 3.x (1990s format)	not supported — re-save as HWP 5/HWPX

Example prompts

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

MIT © Appmonster