HWP Document Tools
An MCP server for reading, writing, and managing Korean Hangul Word Processor (HWP/HWPX) files. It allows users to extract content, fill templates, and create new documents directly through AI assistants.
What is HWP Document Tools?
HWP Document Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for reading, writing, and managing korean hangul word processor (hwp/hwpx) files. it allows users to extract content, fill templates, and create new documents directly through ai assistants...
An MCP server for reading, writing, and managing Korean Hangul Word Processor (HWP/HWPX) files. It allows users to extract content, fill templates, and create new documents directly through AI assistants.
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An MCP server for reading, writing, and managing Korean Hang
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx hwpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use HWP Document Tools
hwp-mcp is an MCP server that enables AI assistants to read, write, and manage Korean Hangul Word Processor (HWP and HWPX) files without requiring Hancom Office to be installed. It exposes 34 tools covering text extraction, table reading, image extraction, template filling, find-and-replace, structural editing (adding/deleting paragraphs and table rows), cell merging, text formatting, and rendering pages to SVG or HTML. This is particularly valuable for Korean-language document workflows where HWP is the dominant format.
Prerequisites
- Node.js 20+ installed (required — earlier versions are not supported)
- An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
- HWP or HWPX files you want to work with (Hancom Office installation is NOT required)
- macOS, Windows, or Linux operating system
Add the server to Claude Code
If using Claude Code, register hwp-mcp with a single command. The server is fetched and run automatically via npx.
claude mcp add hwp-mcp -- npx -y hwp-mcpOr add to Claude Desktop config
For Claude Desktop, add the server to your settings JSON file. No environment variables are required.
{
"mcpServers": {
"hwp-mcp": {
"command": "npx",
"args": ["-y", "hwp-mcp"]
}
}
}Restart your MCP client
Fully restart Claude Desktop or your client after editing the config. The 34 hwp-mcp tools are registered at startup.
Verify the server is connected
In Claude Code, run the list command to confirm hwp-mcp shows as connected.
claude mcp list | grep hwp-mcp
# Expected output: ✓ ConnectedTest with a simple read operation
Ask your AI client to read a local HWP or HWPX file to confirm everything is working.
HWP Document Tools Examples
Client configuration
Claude Desktop and Cursor configuration for hwp-mcp. No environment variables needed.
{
"mcpServers": {
"hwp-mcp": {
"command": "npx",
"args": ["-y", "hwp-mcp"]
}
}
}Prompts to try
Example prompts to use once hwp-mcp is connected in your MCP client.
- "Read ~/2026_plan.hwpx and summarize the main sections"
- "Fill the template form.hwpx: replace {{name}} with John and {{date}} with 2026-06-15"
- "In doc.hwpx, find all occurrences of '인공지능' and replace with 'AI'"
- "Extract all tables from report.hwpx and show them as Markdown"
- "Create a new file new.hwpx with two paragraphs: 'Introduction' and 'Conclusion'"Troubleshooting HWP Document Tools
Server shows '✗ Failed to connect' in claude mcp list
Upgrade to the latest version by changing the args to ['-y', 'hwp-mcp@latest']. Version v0.2.1+ fixed a connection issue. Also ensure Node.js 20+ is installed: run 'node --version' to check.
Tools are not visible in the AI client after adding the server
Tools are registered at startup. Fully close the application (including system tray on Windows/macOS) and restart it. Tools will appear in a new session.
Write operations fail on .hwp files
The 15 write tools only support .hwpx format (the newer XML-based format). For .hwp files (older binary format), only the 5 read tools and 4 rendering tools are available. Convert the file to .hwpx first if editing is needed.
Frequently Asked Questions about HWP Document Tools
What is HWP Document Tools?
HWP Document Tools is a Model Context Protocol (MCP) server that mcp server for reading, writing, and managing korean hangul word processor (hwp/hwpx) files. it allows users to extract content, fill templates, and create new documents directly through ai assistants. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install HWP Document Tools?
Follow the installation instructions on the HWP Document Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with HWP Document Tools?
HWP Document Tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is HWP Document Tools free to use?
Yes, HWP Document Tools is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
HWP Document Tools Alternatives — Similar File Systems Servers
Looking for alternatives to HWP Document Tools? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up HWP Document Tools in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use HWP Document Tools?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.