kordoc MCP Server: Setup for Claude Code, Cursor and Other Apps

• Reads a document and returns it as Markdown

  Converts HWP, HWPX, PDF, XLSX, DOCX, PPTX and PNG, JPG or WebP images to Markdown. Images are read with built-in OCR.

  Try: “Read ~/Documents/공문.hwpx and summarise it.”

  Files · parse_document

• Reads only some pages

  Parses a page range of a document.

  Try: “Read pages 3 to 5 of report.pdf.”

  Files · parse_pages

• Pulls out one table

  Extracts the Nth table from a document.

  Try: “Get the second table from budget.hwpx.”

  Files · parse_table

• Reads title, author and dates

  Reads document properties without parsing the whole file.

  Try: “Who wrote this document and when?”

  Files · parse_metadata

• Identifies the file type

  Detects the format from the file contents, such as hwpx, hwp, pdf or docx.

  Try: “What type of file is this?”

  Files · detect_format

• Splits a document into search chunks

  Parses a document into structured chunks for RAG, keeping headings as a path and putting tables in their own chunks.

  Try: “Split guide.pdf into chunks for indexing.”

  Files · parse_chunks

• Shows what changed between two documents

  Compares two documents block by block and lists added, removed and changed parts. HWP and HWPX can be compared with each other.

  Try: “Compare the old and new regulation files.”

  Files · compare_documents

• Reads the fields of a form

  Extracts label and value pairs from a Korean form document as JSON.

  Try: “List the fields in application.hwpx.”

  Files · parse_form

• Fills in a form

  Fills blank fields in a form and writes a new document. Built-in standard government templates are available. HWPX output keeps the original formatting.

  Try: “Fill in this application with the values from values.json.”

  Write · fill_form

• Edits text and keeps the formatting

  Writes your edited Markdown back into an HWPX or HWP file, keeping fonts, tables, seals and logos. It can also copy a sample file's format for new content.

  Try: “Update the dates in notice.hwpx and save a new file.”

  Write · patch_document

• Adds a seal or signature image

  Places a seal or signature image next to an anchor phrase and saves a new HWPX.

  Try: “Stamp the seal next to "담당자".”

  Write · place_seal

• Adds a comment to a document

  Adds a memo to the text at an anchor phrase and saves a new HWPX.

  Try: “Add a memo on the budget line.”

  Write · add_memo

• Masks personal data

  Finds ID numbers, phones, emails, cards, accounts and more, and writes a masked copy. A dry run only reports what it finds.

  Try: “Mask personal data in list.hwpx and save list_masked.hwpx.”

  Write · redact_document

• Makes an HWPX document from Markdown

  Creates a Korean official-style HWPX document from Markdown, with presets, templates or an agency pack.

  Try: “Turn this Markdown into a report HWPX.”

  Write · generate_document

• Copies a table style

  Extracts the table style of a reference HWPX as JSON so generated tables can match it.

  Try: “Take the table style from sample.hwpx.”

  Files · extract_profile

• Builds an agency style pack

  Builds a .kpack from a few of an organization's HWPX files, keeping layout and logos but clearing text and personal details.

  Try: “Make a style pack from these three reports.”

  Write · build_agency_pack

• Reads an agency pack's writing rules

  Shows a .kpack summary and writing guidance before documents are generated from it.

  Try: “What are the rules in 광양시.kpack?”

  Files · agency_pack_info

• Checks a government document

  Checks notation, plain language, tone, structure and budget numbers in a text or file, and returns findings with line numbers.

  Try: “Lint this draft against official document rules.”

  Files · lint_document

• Converts HWP to HWPX

  Converts HWP files to HWPX and saves them. HWP 5.x keeps its formatting. It refuses to overwrite an existing file unless you give a path.

  Try: “Convert old.hwp to HWPX.”

  Write · convert_to_hwpx

• Shows a document as images or files

  Renders HWPX or HWP as PNG or JPEG images, or saves SVG, HTML or PDF files, so you can check a result.

  Try: “Render page 1 of the generated report.”

  Write · render_document

• Cuts tables and images out of pages

  Renders a document and saves cropped images of tables, pictures and shapes with a regions list.

  Try: “Crop all tables from report.hwpx.”

  Write · crop_regions

• Finds and classifies tables

  Extracts tables from HWPX or HWP and labels them as data tables, layout tables like org charts, or uncertain.

  Try: “Which tables in report.hwpx are real data tables?”

  Write · extract_tables

Watch out for

• It writes new document files

  Fill, patch, convert, mask and render tools save files. Each needs an output path, and the path is checked for allowed file types, symbolic links and the allowed folder. github.com

• Documents can hold personal data

  Files you open are read into the chat. Use the masking tool first, or set KORDOC_ROOT so it only reaches one folder. github.com

• Offline mode is available

  Setting KORDOC_OFFLINE=1 blocks all outside communication, and KORDOC_ROOT limits file access to a folder. github.com

Security advisories