SkillFoxx

hwp-mcp

MCP server that reads, edits and creates Korean HWP and HWPX documents without Hancom Office on macOS, Windows and Linux.

  • 107 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • The server reads and edits document files on disk, with writing possible only to `.hwpx`.
All reasons and checks

treesoop/hwp-mcpAuthor:treesoop

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/hwp-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The server reads and edits document files on disk, with writing possible only to `.hwpx`.

This is third-party code. Review the repository files before installing.

What it does

hwp-mcp lets an agent work with Hancom Office documents: `.hwp` and `.hwpx`. Both formats can be read and rendered, but writing is `.hwpx` only. Version 0.3 exposes 35 tools. Reading returns body text, tables as Markdown with merged cells handled, an image list, headers and footers, footnotes and equations. Rendering turns pages into SVG or HTML. Writing covers text replacement, template filling with `{{name}}` placeholders, paragraph and table cell replacement, image insertion and deletion and creating a new `.hwpx` from text. The WebAssembly engine (the rhwp project) works without Hancom Office COM automation, so the server runs on macOS, Windows and Linux. The author added an agent layer and a ZIP-level workaround for the `.hwpx` export limitation.

Who it is for. People who work with Korean official documents and have an agent read, fill and edit HWP and HWPX.

Good fit when

  • Text in a `.hwp` file needs reading with tables, headers and footnotes.
  • A template with `{{name}}` placeholders is filled with data from a list.
  • A string is replaced across a `.hwpx` document.
  • On a Mac you need to open a document without Hancom Office.

Not a fit when

  • You need to write to a binary `.hwp` file; it is not supported, so first save the document as `.hwpx` in Hancom Office.
  • You need printing and an exact page layout; rendering uses the rhwp engine.
  • A target string is split across two text nodes; replacement will not find it.

Example request

Read report.hwpx with tables and footnotes, then replace the string 2025 with 2026 and save a copy.

MCP

Transport
stdio
Authentication
not required

Limitations

Writing works only for `.hwpx`: a binary `.hwp` is read but not written because of a round-trip conversion limit in rhwp 0.7.7. Open such a file in Hancom Office and save it as `.hwpx`, then use the write tools. Replacement does not find a string split across two text nodes, the same as Hancom's own hwpctl. Inserting new tables is marked experimental: the file is valid but the engine recognizes it only partly. Node.js 20 or newer is required. Documentation is in Korean. The author notes that the engine doing the core format work is Edward Kim's rhwp.

How to disable. Remove the entry with `claude mcp remove hwp-mcp` or delete the `hwp-mcp` block from the client's JSON settings.

FAQ

How do I connect hwp-mcp to Claude Code?

Run `claude mcp add hwp-mcp -- npx -y hwp-mcp`. For Claude Desktop, Cursor and VS Code add JSON with `npx` and the arguments `-y` and `hwp-mcp` to MCP settings.

Is Hancom Office required?

No. The WebAssembly engine runs on macOS, Windows and Linux without Hancom Office or Windows COM automation.

Can I write to a .hwp file?

No. Writing is supported only for `.hwpx`. Save the document as `.hwpx` in Hancom Office and then use the write tools.

How do I verify the install?

With `claude mcp list | grep hwp-mcp`, which should show Connected. Then ask the agent to create `hello.hwpx` with one line.

Which read tools exist?

`read_hwp` for text, tables and the image list, `read_hwp_text` for text with headers, footers, footnotes and equations and `read_hwp_tables` for tables as Markdown.

Discussion

No questions or reviews yet.

MCP servers

An MCP server and CLI for Korean HWPX documents: text and table edits, form filling and plan-based document creation.

MCP serverExtended access69

A skill that reads, creates and edits Korean hwp and hwpx documents from the agent, with no Hancom Office and no conversion

SkillExtended access222

CLI and MCP server that turn Korean HWP and HWPX, PDF and Office files into Markdown and fill forms from templates

MCP serverBroad access3K

A skill that creates and edits HWPX documents, converts HWP, and builds official letters and reports from a JSON spec

SkillExtended access308
Official

Adeu: an MCP server, skill and CLI for editing .docx through an agent with real Track Changes, comments and version diffs.

MCP serverExtended access170

MCP Word server for docx editing with tracked changes: comments, footnotes, version comparison and a change log, all visible in Word

MCP serverBroad access69

README in short

The server wraps the rhwp engine in MCP tools that AI agents can use and adds `.hwpx` writing by modifying the ZIP archive.

README badge

Report a problem