hwp-mcp

Overview

hwp-mcp is a specialized MCP server built on the rhwp engine that provides comprehensive functionality for working with Korean Hangul documents (.hwp/.hwpx). It offers 34 tools for both reading and writing operations, including document parsing, template filling, text replacement, table manipulation, image extraction, and rendering to SVG/HTML. The server acts as an adapter between the rhwp Rust+WASM engine and AI agents, enabling natural language document manipulation through MCP-compatible clients like Claude, Cursor, and ChatGPT. While reading works with both formats, writing currently supports .hwpx only, with .hwp write support planned for future versions.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• read_hwp

  Reads HWP document content including text and tables

  Try:Read this HWP document for meTry:What's in this .hwpx file?
• fill_hwp_template

  Fills placeholders in a HWP template

  Try:Fill this HWP template with {{name}}=John, {{company}}=Acme CorpTry:Replace the placeholders in this form
• replace_hwp_text

  Replaces text in a HWP document

  Try:Replace 'AI' with 'Artificial Intelligence' in this documentTry:Change all instances of 'old company name' to 'new company name'
• get_hwp_info

  Retrieves metadata and statistics about a HWP document

  Try:Tell me about this HWP documentTry:How many pages are in this file?
• render_hwp_page

  Renders a specific HWP page as SVG

  Try:Convert page 1 of this HWP to SVGTry:Show me the first page visually
• list_hwp_images

  Lists all embedded images in a HWP document

  Try:What images are in this HWP file?Try:Extract all images from this document
• set_hwp_paragraph_text

  Replaces the entire text of a specific paragraph

  Try:Replace the text of paragraph 3Try:Change the introduction paragraph
• insert_hwp_image

  Inserts a new image into a HWP document

  Try:Add this logo image to the documentTry:Insert image at the beginning
• create_hwpx_document

  Creates a new HWPX document with text content

  Try:Create a new HWPX document with this textTry:Generate a blank document
• read_hwp_tables

  Extracts tables from a HWP document as markdown

  Try:Get all tables from this HWPTry:Extract the first table as markdown
• set_hwp_cell_text

  Sets text in a specific table cell

  Try:Set the text in row 2, column 3Try:Update the value in this table cell
• append_hwp_paragraph

  Adds a new paragraph to the end of a HWP document

  Try:Add a conclusion paragraph at the endTry:Append this text to the document

Comparable tools

Installation

claude mcp add hwp-mcp -- npx -y hwp-mcp

{
  "mcpServers": {
    "hwp-mcp": {
      "command": "npx",
      "args": ["-y", "hwp-mcp"]
    }
  }
}

FAQ

What document formats are supported?

Reading works with both .hwp and .hwpx formats. Writing currently supports only .hwpx, with .hwp write support planned for v0.3.

Can I use this with AI assistants other than Claude?

Yes, hwp-mcp is compatible with any MCP-compliant client including Cursor, ChatGPT, and others that support MCP servers.

Does it support complex document features like charts and bookmarks?

These features are not yet implemented. Current coverage is approximately 85%, with major features like .hwp write support, charts, and style definitions planned for v0.3.

Compare hwp-mcp with