AI 에이전트로 한글(HWP) 문서를 읽고 작성할 수 있을까?Can an AI agent read and write Korean HWP documents?
지금 가능Works today
kordoc, hwp-mcp 같은 오픈소스 MCP를 연결하면 Claude·Codex가 한컴오피스 없이 .hwp·.hwpx를 읽고, .hwpx 문서를 새로 만들거나 양식을 채웁니다. 다만 .hwp(바이너리) 파일을 직접 고쳐 저장하는 기능은 아직 도구마다 제한이 있어 .hwpx로 다루는 편이 안전합니다.
Open-source MCP servers such as kordoc and hwp-mcp let Claude or Codex read .hwp/.hwpx files and create or fill .hwpx documents without Hancom Office. Editing and saving legacy binary .hwp is still limited in most tools, so working in .hwpx is safer.
연결하는 방법How to connect an agent
제3자 도구(비공식)Third-party tool (unofficial)
kordoc (읽기·변환·양식 채우기)kordoc (read, convert, fill forms)
npx -y kordoc setup을 실행하면 Claude Desktop·Claude Code·Cursor·Codex에 MCP가 등록되어 HWP·HWPX·PDF를 마크다운으로 읽고, 문서를 비교하고, 양식을 채우고, 마크다운으로 HWPX 공문서를 만듭니다. 현직 지방공무원이 만든 도구로 소개합니다.Run npx -y kordoc setup to register the MCP in Claude Desktop, Claude Code, Cursor or Codex; it reads HWP/HWPX/PDF as markdown, diffs documents, fills forms and generates HWPX official documents from markdown. Built by a local civil servant.
필요한 것You needNode.js 20+한컴오피스 불필요No Hancom Office needed
hwp-mcp (rhwp 기반 읽기·쓰기)hwp-mcp (read/write, built on rhwp)
claude mcp add hwp-mcp -- npx -y hwp-mcp로 연결하면 .hwp·.hwpx 읽기, 페이지 렌더링, .hwpx 텍스트 치환·템플릿 채우기·표 편집·새 문서 만들기를 맥·윈도우·리눅스에서 할 수 있습니다. .hwp 파일 쓰기는 지원하지 않습니다.Connect with claude mcp add hwp-mcp -- npx -y hwp-mcp to read .hwp/.hwpx, render pages, and replace text, fill templates, edit tables or create new .hwpx files on macOS, Windows or Linux. Writing .hwp is not supported.
claude plugin marketplace add https://github.com/DoHyun468/claw-hwp 후 claude plugin install claw-hwp@claw-hwp로 설치하면 대화로 문서 서식·표·차트를 편집합니다. Codex도 같은 저장소로 설치하며, 결과 파일이 한컴오피스에서 깨지지 않게 저장한다고 소개합니다.Install with claude plugin marketplace add https://github.com/DoHyun468/claw-hwp then claude plugin install claw-hwp@claw-hwp to edit formatting, tables and charts by chat; Codex installs from the same repo. It says output opens cleanly in Hancom Office.
필요한 것You needClaude Code 또는 CodexClaude Code or Codex
한컴이 판매하는 개발 라이브러리로, 한글 프로그램 없이 HWP·HWPX 생성·변환·편집·비교 기능을 자사 시스템에 넣을 수 있습니다. 개인용 MCP가 아니라 기업이 구매해 탑재하는 제품입니다.Hancom's commercial library for creating, converting, editing and comparing HWP/HWPX inside your own system without the Hwp app. It is a product companies buy and embed, not a personal MCP.
한컴이 직접 만든 MCP 서버는 확인되지 않았습니다. 위 MCP는 모두 개인 개발자의 비공식 도구입니다.No Hancom-built MCP server was found; all MCPs above are unofficial community tools.
공문서·계약서는 AI가 고친 뒤 한컴오피스에서 직접 열어 서식과 내용을 확인하세요.For official documents or contracts, open the AI-edited file in Hancom Office and check layout and content yourself.
개인정보나 내부 문서가 담긴 파일은 외부 AI로 보내기 전에 범위를 줄이고, 폐쇄망이면 kordoc의 오프라인 모드(`KORDOC_OFFLINE=1`)를 검토하세요.Trim personal or internal data before sending files to an external AI; for air-gapped networks consider kordoc's offline mode (`KORDOC_OFFLINE=1`).
행정안전부가 2026년 5월부터 공공기관 전자문서에 개방형 형식(HWPX) 사용을 의무화해, 앞으로는 HWPX 문서가 더 많아질 것으로 보입니다.Since May 2026 the Ministry of the Interior requires open-format (HWPX) public documents, so HWPX will become more common.
공개 자료를 바탕으로 2026.10.12에 정리했습니다. 모든 방법을 직접 실행해 검증한 결과는 아니며, 도구 소개가 공식 지원이나 안전을 보장하지 않습니다. 이용 약관과 최신 문서를 함께 확인해 주세요.Compiled from public sources on 2026.10.12. Not every path was executed by us; listing a tool does not guarantee official support or safety. Check the terms and current docs.정정 제보Suggest a correction
류주임이 한글·PDF·오피스 문서를 마크다운으로 바꾸고 양식 채우기와 신구대조를 지원하는 CLI·MCP를 공개했다. 2026-03 생성, 별 약 2,400개.The same Gwangjin-gu developer released kordoc, converting HWP/HWPX/PDF/Office files to Markdown with form filling and diffing via CLI and MCP (created 2026-03, ~2,400 stars).
대안·대응Alternatives noted · LLM이 직접 못 읽는 HWP를 파서로 변환해 우회했다.
treesoop은 rhwp(WASM) 위에 hwp-mcp를 얹어 한컴오피스 없이 HWP 읽기와 HWPX 템플릿 채우기·표 수정을 지원한다. 기존 도구 대부분이 윈도우 COM에 묶인 점을 우회했다.treesoop built hwp-mcp on the rhwp WASM engine to read HWP and fill/edit HWPX without Hancom Office, avoiding the Windows-only COM approach (repo created 2026-03).
대안·대응Alternatives noted · HWP 쓰기가 막혀 있어 HWPX는 ZIP 단위 수정 계층으로 우회했고, .hwp 쓰기는 아직 미지원이다.
6aneffy의 hwpx-kit은 양식 채우기·메일머지·표 생성·공문서 검수를 Claude Code 플러그인과 CLI로 제공한다. 2026-07 생성.6aneffy's hwpx-kit offers form filling, mail merge, table generation and official-document checks as a Claude Code plugin and CLI (created 2026-07).
대안·대응Alternatives noted · 한글 문서 포맷을 직접 다루는 도구로 우회했다.
kangdacool은 Claude Code·Codex가 hwpx를 안전하게 편집하도록 검증된 규칙과 파이썬 도구를 담은 스킬을 공개했다. 2026-07 생성.kangdacool published a skill with verified rules and Python tools so Claude Code and Codex can edit .hwpx safely (created 2026-07).
대안·대응Alternatives noted · hwpx 구조 규칙을 스킬로 알려줘 파일 손상을 피했다.
Claude, Codex 등 에이전트와 연결해 .hwpx/.hwp 공문서의 맞춤법·띄어쓰기·조사 병기를 자동 교정하는 MCP를 무료로 공개했다.Published a free MCP letting agents like Claude and Codex auto-correct spelling, spacing and particles in Korean official .hwpx/.hwp documents.
대안·대응Alternatives noted · HWP/HWPX 공문서 형식을 MCP로 직접 다뤄 우회했다.
행정안전부가 공공기관 전자문서에 개방형 형식 준수를 담은 대통령령 개정안을 2026-05-12 국무회의에서 의결했다고 보도됐다.Reported: MOIS's decree amendment requiring open document formats (e.g. hwpx) for public-sector documents passed the Cabinet on 12 May 2026.
대안·대응Alternatives noted · AI가 읽기 어려운 HWP 한계를 제도로 해소하려는 시도.
서울시가 약 18억원 규모로 MCP 기반 에이전트 환경을 구축해 업무관리·회의실·메일 시스템과 연동한다. 시범 3종은 HWP/HWPX/PDF 문서 요약, 자연어 회의실 예약, 제안평가위원 문자 섭외 자동화다.Seoul ordered a ~KRW 1.8B MCP-based agent layer linked to its work-management, room-booking and mail systems; pilots summarise HWP/HWPX/PDF documents, book rooms by natural language, and auto-text evaluation-committee candidates.
대안·대응Alternatives noted · 행정문서가 HWP·HWPX 형식이라 문서 요약 에이전트가 이를 직접 분석하고 내부망 자체 LLM에서 구동한다.
Kminer2053의 gongmuwon은 인터넷 없이 PC 안의 경량 모델(Ollama)로 대화·지식폴더 근거 검색·일정 등록 후 한글(HWPX) 보고서까지 만든다. 자료가 PC 밖으로 나가지 않는다고 밝힌다.Kminer2053's gongmuwon desktop app runs a lightweight local model via Ollama, answers from the user's knowledge folder, registers schedules and produces HWPX reports; the README states data never leaves the PC (created 2026-04).
대안·대응Alternatives noted · 폐쇄망 때문에 클라우드 모델을 못 쓰는 환경을 로컬 모델로 우회했다.