HWP MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@HWP MCP Server Convert the open document to PDF"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
HWP MCP Server
MCP (Model Context Protocol) server that enables LLMs to read and modify binary HWP (한글) documents via the HWP COM API.
Architecture
LLM ↔ MCP Server (Python/FastMCP) ↔ PowerShell Bridge (JSON stdin/stdout) ↔ HWP COM API ↔ 한글Python MCP server manages a long-running PowerShell subprocess that hosts HWP COM objects.
Related MCP server: HWP MCP Server
Requirements
Windows (HWP COM API is Windows-only)
한컴오피스 한글 installed (provides HWP COM server)
PowerShell 5.1+ (included with Windows)
Python >= 3.11
Installation
uv pip install -e .Usage
Run MCP Server
python -m hwp_mcp.serverClaude Desktop Config
{
"mcpServers": {
"hwp": {
"command": "uv",
"args": ["run", "--directory", "/path/to/hwp-mcp", "hwp-mcp"]
}
}
}MCP Tools (140)
HWP COM API 199 HParameterSet 100% coverage
Document Management (5)
Tool | Description |
| Open HWP document |
| Close document |
| List open documents |
| Save document |
| Save as different name/format |
Read (5)
Tool | Description |
| Extract full text |
| Get paragraph list |
| Get table list |
| Get table data (2D array) |
| Search text |
Write (5)
Tool | Description |
| Replace text |
| Insert text |
| Set table cell text |
| Append paragraph |
| Set document content from text data |
Formatting (3)
Tool | Description |
| Character formatting (font, size, bold, color, etc.) |
| Paragraph formatting (alignment, line spacing) |
| Page formatting (margins, orientation) |
Table (3)
Tool | Description |
| Create table |
| Add table row |
| Delete table row |
Advanced (5)
Tool | Description |
| Execute arbitrary HWP action (power user) |
| Convert HWP → HWPX |
| Convert HWP → PDF |
| Batch convert files (HWP, PDF, DOCX, etc.) |
| File security settings (copy/print restriction) |
Cursor & Navigation (11)
Tool | Description |
| Move cursor to specified position |
| Get current cursor position |
| Set cursor position (list, para, pos) |
| Get cursor position as set |
| Set cursor position from set |
| Get selection start/end positions |
| Select text range by coordinates |
| Get current selection info |
| Clear selection |
| Delete selected content |
| Initialize document scan |
Field (12)
Tool | Description |
| Create named field (template placeholder) |
| Check if field exists |
| Get all field names |
| Read field text |
| Set field text |
| Get field name at cursor |
| Set current field name |
| Move cursor to field |
| Rename field |
| Modify field properties |
| Set field control properties |
| Batch fill multiple fields |
Advanced Table (11)
Tool | Description |
| Add table column |
| Delete table column |
| Merge cells |
| Split cell |
| Cell style (background, vertical alignment) |
| Table border style |
| Table → text conversion |
| Text → table conversion |
| Swap table rows/columns |
| Apply table template |
Enhanced Formatting (5)
Tool | Description |
| Extended character properties (kerning, spacing, shadow, etc.) |
| Bullet style |
| Numbering style |
| Tab stops |
| Create/delete/apply styles |
Page & Section (10)
Tool | Description |
| Section definition (binding margin, text flow) |
| Page border and background |
| Multi-column layout |
| Page number |
| Header/footer |
| Footnote style |
| Master page |
| Hide page elements (header/footer, etc.) |
| Page number control (restart numbering) |
| Text direction (horizontal/vertical) |
Image & Equation (3)
Tool | Description |
| Insert picture |
| Insert background picture |
| Insert equation |
Form Control (3)
Tool | Description |
| Insert form control (button, checkbox, etc.) |
| Set form control properties |
| Read form data |
Document Info (5)
Tool | Description |
| Document metadata (page count, modified state) |
| Document summary (title, author) |
| Extract specific page text |
| Total page count |
| Export page as image |
Print & Export (3)
Tool | Description |
| Print document |
| Set watermark (text/image) |
| Save document as image |
Utility (4)
Tool | Description |
| Unit conversion (mm, pt, hwpunit) |
| RGB/Hex → HWP color value |
| Run HWP macro |
| File metadata (without opening) |
Bookmark & Hyperlink (6)
Tool | Description |
| Insert bookmark |
| Insert hyperlink |
| Jump to hyperlink target |
| Insert index mark |
| Insert auto number field |
| Insert cross reference |
Header/Footer & Caption (2)
Tool | Description |
| Drop cap (decorative first letter) |
| Table/image caption |
Document Operations (8)
Tool | Description |
| Sort text |
| Spell check |
| Track changes |
| Mail merge |
| Generate table of contents |
| Insert another file |
| Document password |
| Save selection to file |
Compatibility & Settings (3)
Tool | Description |
| Document compatibility mode |
| HWP view properties (zoom, view mode, etc.) |
| HWP engine properties (spell check, auto-save, etc.) |
Control & Object (4)
Tool | Description |
| Delete selected control |
| Find control |
| Check X object existence |
| Release scan resources |
Style & Script (4)
Tool | Description |
| Import style |
| Export style |
| Run HWP script |
| Get script source |
System & Security (11)
Tool | Description |
| Register COM module |
| DRM authority |
| Lock/unlock command |
| Check command lock status |
| Message box mode |
| Get message box mode |
| Check action enabled |
| Replace action handler |
| Get HWP COM property |
| Set HWP COM property |
| String → HWP enum value |
HParameterSet Actions (10)
Tool | Description | HParameterSet Count |
| Table actions | 14 |
| File actions | 11 |
| Draw object actions | 22 |
| Shape actions | 6 |
| Style/border actions | 6 |
| Form actions | 13 |
| Document info actions | 9 |
| Hanja/conversion actions | 11 |
| Selection/position actions | 6 |
| Miscellaneous actions | 69 |
Project Structure
hwp-mcp/
├── src/hwp_mcp/
│ ├── __init__.py
│ ├── _core.py # FastMCP instance & shared helpers
│ ├── server.py # Entry point, imports all tool modules
│ ├── bridge.py # PowerShell subprocess manager
│ ├── commands.py # JSON command builders
│ └── tools/ # MCP tool definitions (140 tools)
│ ├── cursor.py
│ ├── doc_info.py
│ ├── document.py
│ ├── drawing.py
│ ├── field.py
│ ├── form.py
│ ├── formatting.py
│ ├── hparam.py
│ ├── hwpobject.py
│ ├── page_section.py
│ ├── print_export.py
│ ├── system.py
│ ├── table.py
│ ├── text.py
│ └── utility.py
├── scripts/
│ ├── hwp_bridge.ps1 # PowerShell COM bridge dispatcher
│ └── handlers/ # 12 handler modules
│ ├── document.ps1
│ ├── text.ps1
│ ├── table.ps1
│ ├── style_format.ps1
│ ├── action.ps1
│ ├── cursor_selection.ps1
│ ├── field.ps1
│ ├── draw_object.ps1
│ ├── form_control.ps1
│ ├── document_info.ps1
│ ├── print_export.ps1
│ ├── utility.ps1
│ └── hwpobject_methods.ps1
├── tests/
│ ├── test_bridge.py # Bridge unit tests
│ ├── test_commands.py # Command builder unit tests
│ └── test_server.py # Server tool unit tests
└── pyproject.tomlDevelopment
uv pip install -e ".[dev]"
pytest tests/ -v
ruff check src/ tests/Limitations
Windows only: HWP COM API requires Windows
한글 required: 한컴오피스 한글 must be installed
Binary HWP only: HWPX (XML-based) needs a separate server
License
MIT
Available Tools
140 toolsadd_table_columnA
Add a column to a table.
Args: doc_id: Document ID from open_document table_index: Index of the table col_index: Position to insert (default: append at end)
Inputs: doc_id (required), table_index (required), col_index. Returns: object
add_table_rowA
Add a new row to a table.
Args: doc_id: Document ID from open_document table_index: Index of the table position: Row position to insert at (default: end)
Returns: Row addition confirmation
Inputs: doc_id (required), table_index (required), position. Returns: object
append_paragraphA
Append a new paragraph to the end of the document.
Args: doc_id: Document ID from open_document text: Paragraph text
Returns: Append confirmation
Inputs: text (required), doc_id (required). Returns: object
apply_table_templateC
Apply a template to the current table.
Args: doc_id: Document ID from open_document filename: Template file path format: Template format apply_target: Bitmask of what to apply create_mode: Creation mode
Inputs: doc_id (required), format, filename, create_mode, +1 more. Returns: object
batch_convert_filesB
Batch convert files between formats (HWP, HWPX, PDF, DOCX, etc.).
Args: doc_id: Document ID from open_document src_files: List of source file paths dest_files: List of destination file paths format: Target format string
Inputs: doc_id (required), format, src_files, dest_files. Returns: object
batch_fill_fieldsA
Fill multiple fields at once (batch operation).
Args: doc_id: Document ID from open_document fields: Dict mapping field names to text values
Inputs: doc_id (required), fields (required). Returns: object
check_x_objectB
Check if an X object exists by name.
Args: doc_id: Document ID from open_document name: Name of the X object to check
Inputs: name (required), doc_id (required). Returns: object
clear_selectionC
Clear the current text selection.
Inputs: doc_id (required). Returns: object
close_documentA
Close an open document.
Args: doc_id: Document ID from open_document
Returns: Confirmation with status
Inputs: doc_id (required). Returns: object
convert_to_hwpxA
Convert HWP document to HWPX format.
Args: doc_id: Document ID from open_document output_path: Output file path for the HWPX file
Returns: Conversion confirmation with path
Inputs: doc_id (required), output_path (required). Returns: object
convert_to_pdfA
Export document as PDF.
Args: doc_id: Document ID from open_document output_path: Output file path for the PDF
Returns: Conversion confirmation with path
Inputs: doc_id (required), output_path (required). Returns: object
convert_unitsC
Convert between units (mm, pt, hwpunit).
Inputs: value (required), doc_id (required), to_unit (required), from_unit (required). Returns: object
create_equationC
Create an equation using HWP equation syntax.
Inputs: doc_id (required), equation (required), font_name, font_size. Returns: object
create_fieldA
Create a named field (placeholder for templates).
Args: doc_id: Document ID from open_document name: Field name direction: 0 = horizontal, 1 = vertical memo: Field memo/description
Inputs: name (required), doc_id (required), memo, direction. Returns: object
create_tableA
Create a new table in the document.
Args: doc_id: Document ID from open_document rows: Number of rows cols: Number of columns data: Optional 2D array of initial cell values
Returns: Table creation confirmation
Inputs: cols (required), rows (required), doc_id (required), data. Returns: object
delete_ctrlC
Delete the currently selected control object.
Args: doc_id: Document ID from open_document
Inputs: doc_id (required). Returns: object
delete_selectionC
Delete the selected content.
Args: doc_id: Document ID from open_document option: Delete option (0 = selected content)
Inputs: doc_id (required), option. Returns: object
delete_table_columnB
Delete a column from a table.
Args: doc_id: Document ID from open_document table_index: Index of the table col_index: Index of the column to delete
Inputs: doc_id (required), col_index (required), table_index (required). Returns: object
delete_table_rowB
Delete a row from a table.
Args: doc_id: Document ID from open_document table_index: Index of the table row_index: Index of the row to delete
Returns: Row deletion confirmation
Inputs: doc_id (required), row_index (required), table_index (required). Returns: object
export_page_as_imageC
Export a page as an image file (bmp, jpg, png).
Inputs: doc_id (required), output_path (required), page_number (required), dpi, +1 more. Returns: object
export_styleC
Export a style from the document.
Args: doc_id: Document ID from open_document style: Style name to export
Inputs: style (required), doc_id (required). Returns: object
field_existsC
Check if a named field exists in the document.
Args: doc_id: Document ID from open_document name: Field name to check
Inputs: name (required), doc_id (required). Returns: object
find_ctrlC
Find a control object in the document.
Args: doc_id: Document ID from open_document
Inputs: doc_id (required). Returns: object
get_current_fieldC
Get the field name at the current cursor position.
Args: doc_id: Document ID from open_document option: Detection option
Inputs: doc_id (required), option. Returns: object
get_cursor_positionA
Get the current cursor position (list, para, pos).
Inputs: doc_id (required). Returns: object
get_document_infoB
Get document metadata (page count, modification status, path, version).
Inputs: doc_id (required). Returns: object
get_document_summaryC
Get or set document summary info (title, author, subject, keywords).
Inputs: doc_id (required), values. Returns: object
get_document_textB
Get all text content from the document.
Args: doc_id: Document ID from open_document
Returns: Full text content
Inputs: doc_id (required). Returns: object
get_field_listA
Get list of all fields in the document.
Args: doc_id: Document ID from open_document option: 0 = all fields, 1 = clickhere fields only direction: 0 = horizontal, 1 = vertical
Inputs: doc_id (required), option, direction. Returns: object
get_field_textB
Get the text content of a named field.
Args: doc_id: Document ID from open_document name: Field name
Inputs: name (required), doc_id (required). Returns: object
get_file_infoA
Get file metadata without opening the document.
Inputs: file_path (required). Returns: object
get_form_dataC
Get form control data from the document.
Inputs: doc_id (required). Returns: object
get_hwp_propertyB
Get a property value from HWP COM object.
Args: property_name: Property name (e.g. "Version", "CurFieldName")
Inputs: property_name (required). Returns: object
get_message_box_modeA
Get current message box mode.
Inputs: no named parameters. Returns: object
get_page_countC
Get the total page count of the document.
Inputs: doc_id (required). Returns: object
get_page_textB
Get text content of a specific page (1-based page number).
Inputs: doc_id (required), page_number (required), option. Returns: object
get_paragraphsA
Get paragraphs from the document.
Args: doc_id: Document ID from open_document start: Starting paragraph index limit: Maximum number of paragraphs to return
Returns: List of paragraphs with text and index
Inputs: doc_id (required), limit, start. Returns: object
get_pos_by_setB
Get current cursor position as list/para/pos set.
Args: doc_id: Document ID from open_document
Inputs: doc_id (required). Returns: object
get_script_sourceA
Get the source code of a named script.
Args: doc_id: Document ID from open_document name: Script name to retrieve
Inputs: name (required), doc_id (required). Returns: object
get_selected_pos_by_setA
Get selected range start and end positions.
Args: doc_id: Document ID from open_document
Inputs: doc_id (required). Returns: object
get_selection_infoC
Get information about the current text selection.
Inputs: doc_id (required). Returns: object
get_table_dataA
Get full table data as a 2D array.
Args: doc_id: Document ID from open_document table_index: Index of the table
Returns: 2D array of cell text values
Inputs: doc_id (required), table_index (required). Returns: object
get_tablesB
Get tables from the document.
Args: doc_id: Document ID from open_document
Returns: List of tables with metadata
Inputs: doc_id (required). Returns: object
hwp_doc_info_param_actionB
Execute HWP action with document info HParameterSet.
Supported param_set_name values and their key properties:
HDocData: DataName, DataType, DataValue, Persistent (bool)
HDocDRM: DRMType, Authority, License, Expiration, AllowPrint (bool), AllowCopy (bool), AllowEdit (bool)
HDocFilters: FilterName, FilterIndex, Description, Extensions
HDocFindInfo: FindString, ReplaceString, MatchCase (bool), WholeWord (bool), UseRegex (bool), Direction (0=forward, 1=backward), Scope (0=all, 1=selection)
HDocumentFilterDialog: FilterType, ShowPreview (bool), InitialDir
HDocumentInfo: PageCount, CharCount, WordCount, LineCount, ParaCount, TableCount, ImageCount, ModifiedDate
HSummaryInfo: Title, Subject, Author, Keywords, Comments, Category, Manager, Company, Version
HVersionInfo: Version, Description, Author, Date, AutoSave (bool)
HAppState: ViewMode (0=edit, 1=read), ZoomLevel, ShowRuler (bool), ShowGrid (bool), ShowParaMark (bool), ShowFieldCode (bool)
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Must be one of the doc info param sets listed above params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hwp_draw_param_actionB
Execute HWP action with draw/shape-related HParameterSet.
Supported param_set_name values and their key properties:
HDrawAlignHorz: AlignType (0=left, 1=center, 2=right, 3=distribute), RelativeTo (0=paper, 1=column, 2=paragraph)
HDrawAlignVert: AlignType (0=top, 1=center, 2=bottom, 3=distribute), RelativeTo
HDrawAttr: Width, Height, Left, Top, HorzRelTo, VertRelTo, TreatAsChar (bool), TextFlow, ZOrder
HDrawChangeAttr: Width, Height, Left, Top, KeepRatio (bool)
HDrawConnect: StartObjID, EndObjID, StartPt, EndPt, ConnectorType
HDrawCurveToLine: Precision, MaxSegments
HDrawDeletePt: PointIndex
HDrawEditGroup: GroupObjID, Action (enter|leave)
HDrawFill: FillType (0=none, 1=color, 2=hatch, 3=gradation, 4=image), FillColor, HatchType, ImagePath, Gradation
HDrawFlip: Direction (0=horizontal, 1=vertical)
HDrawGrid: ShowGrid (bool), SnapToGrid (bool), GridWidth, GridHeight
HDrawGroup: GroupName
HDrawInsertPt: PointIndex, X, Y
HDrawLine: LineType, LineWidth, LineColor, StartArrow, EndArrow, DashStyle, CapType
HDrawMakeCurve: SegmentCount, SmoothLevel
HDrawMovePt: PointIndex, NewX, NewY
HDrawObjCreator: ObjectType (line|rect|ellipse|arc|polygon|curve|textbox), CreateMethod, StartX, StartY, EndX, EndY
HDrawRotate: Angle (degrees), CenterX, CenterY
HDrawSendBackward: Steps (number of layers to move back)
HDrawShadow: ShadowType (0=none, 1=drop, 2=cont), OffsetX, OffsetY, Color, Opacity
HDrawTextbox: Margin, VertAlign, TextDirection, AutoSize (bool)
HDrawUngroup: GroupObjID
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Must be one of the draw param sets listed above params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hwp_enumA
Convert string to HWP enum value.
Supported enum_type values: HAlign, VAlign, TextAlign, FontType, HwpLineType, HwpLineWidth, BorderShape, BrushType, ArcType, DrawShadowType, PageType, NumberFormat, Numbering, TableFormat, ImageFormat.
Args: enum_type: Enum category name value: Enum member string to convert
Inputs: value (required), enum_type (required). Returns: object
hwp_file_param_actionB
Execute HWP action with file-related HParameterSet.
Supported param_set_name values and their key properties:
HFileOpen: filename, Format (HWP|HWPX|HTML|TEXT|DOCX), ArgStr, ReadOnly (bool), VersionBackup
HFileSaveAs: filename, Format, ArgStr, Encrypt (bool), SetPassword, CompatSave, Author
HFileInfo: FileName, Format, FileSize, CreateDate, ModifyDate, Author, Title, Subject
HFileConvert: SrcFormat, DstFormat, SrcFile, DstFile, Overwrite (bool)
HFileSaveBlock: filename, Format, Argument
HFileSaveDaisy: filename, DaisyVersion, DTBookTitle, DTBookAuthor, Language, Publisher
HFileSecurity: Password, ReadPassword, PermitRead, PermitCopy, PermitPrint, CertificatePath
HFileSendMail: To, Cc, Subject, Body, AttachFile
HFileSetSecurity: SecurityLevel, CertPath, SignPassword
HFileXMLSchema: SchemaPath, Namespace, ValidateOnSave
HFileOpenSave: filename, Format, ArgStr (common open/save parameters)
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Must be one of the file param sets listed above params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hwp_form_param_actionA
Execute HWP action with form control HParameterSet.
Supported param_set_name values and their key properties:
HFormCheckBox: Name, Checked (bool), GroupName, Value, EnabledField (bool), ReadOnly (bool)
HFormComboBox: Name, Items (list of strings), SelectedIndex, Editable (bool), ListRows
HFormDate: Name, DateFormat, DefaultDate, MinDate, MaxDate
HFormDropDown: Name, Items (list of strings), SelectedIndex, Width
HFormEdit: Name, Text, MaxLength, PasswordChar, MultiLine (bool), ReadOnly (bool), InputMask
HFormListBox: Name, Items (list), SelectedIndex, MultiSelect (bool), ListRows, Width, Height
HFormNumber: Name, Value, MinValue, MaxValue, DecimalPlaces, SpinButton (bool)
HFormOLE: Name, CLSID, Width, Height, ProgID, DisplayAsIcon (bool)
HFormPopupButton: Name, Caption, Width, Height, Action
HFormPushButton: Name, Caption, Width, Height, OnClick (script)
HFormRadioButton: Name, GroupName, Checked (bool), Value, Label
HFormScrollBar: Name, Min, Max, Value, SmallChange, LargeChange, Orientation (0=horizontal, 1=vertical)
HFormTextArea: Name, Text, Rows, Cols, MaxLength, ReadOnly (bool), ScrollBars (0=none, 1=horizontal, 2=vertical, 3=both)
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Must be one of the form param sets listed above params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hwp_hanja_param_actionB
Execute HWP action with hanja/conversion HParameterSet.
Supported param_set_name values and their key properties:
HHanjaConversion: ConvertType (0=hanja, 1=hangul), Range (0=all, 1=selection), ShowDialog (bool), ConvertUnit (0=word, 1=char)
HHanjaInfo: OriginalText, ConvertedText, DictionaryType, UserDict
HHanjaReplace: FindText, ReplaceText, Scope, MatchCase (bool)
HHanjaSuggestion: InputText, Suggestions (list), SelectedIndex
HHanjaDict: DictPath, DictType (0=system, 1=user), Editable (bool)
HConvertHangulHanja: Direction (0=toHanja, 1=toHangul), Scope, ShowUI (bool)
HConvertHanjaToHangul: Scope, ShowUI (bool)
HConvertHangulToHanja: Scope, ShowUI (bool), DictPriority
HConvertAll: ConvertType, Scope, ShowUI (bool), ApplyAll (bool)
HConvertSpecial: SpecialType, ConvertMap, Scope
HConvertCharShape: SrcCharShape, DstCharShape, Scope, IncludeFont (bool), IncludeSize (bool), IncludeColor (bool)
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Must be one of the hanja/conversion param sets listed above params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hwp_misc_param_actionA
Execute HWP action with miscellaneous HParameterSet.
This is the catch-all for all 67 remaining HParameterSets not covered by the specialized category tools. Key param_set_name values include:
Section & Page:
HSectionDef: PageWidth, PageHeight, TopMargin, BottomMargin, LeftMargin, RightMargin, HeaderMargin, FooterMargin, GutterType, Orientation
HSecDef: SectionType, TextDirection, PageStartNumber, HideHeader, HideFooter
HPageDef: Landscape (bool), GutterType, BindingMargin
HPageBorderFill: BorderType, FillColor, Position (0=paper, 1=body), OffsetLeft, OffsetRight, OffsetTop, OffsetBottom
HColumnDef: ColumnCount, ColumnType (0=normal, 1=balanced, 2=parallel), SameWidth (bool), ColumnWidths (list), ColumnGap, LineBetween (bool)
HPageNum: Position (0=none, 1=top, 2=bottom, 3=outside, 4=inside), FormatType, StartNumber, ShowOnFirstPage (bool), DashType
HHeaderFooter: Type (0=header, 1=footer), ApplyTo (0=both, 1=even, 2=odd), Text, ShowOnFirstPage (bool), ShowOnLastPage (bool)
HFootnoteShape: NumberFormat, StartNumber, Separator, Position
Character & Paragraph:
HCharShape: FaceName, FontSize, Bold (bool), Italic (bool), Underline, StrikeOut, TextColor, ShadeColor, CharSpacing, CharWidth, Offset, SuperScript
HParaShape: Alignment (0=justify, 1=left, 2=center, 3=right), LineSpacingType, LineSpacing, ParaSpaceBefore, ParaSpaceAfter, IndentLeft, IndentRight, IndentFirst, TabDef, BorderFill
HTabDef: TabType (0=left, 1=right, 2=center, 3=decimal), Position, Leader (0=none, 1=dot, 2=dash, 3=underline)
HBullet: BulletChar, BulletFont, BulletSize, Indent, Hanging
HNumbering: NumberType, StartNumber, Indent, Hanging, FormatString
Insert & Objects:
HInsertText: Text, CharShape, ParaShape
HInsertPicture: Path, Embedded (bool), Width, Height, SizeOption, WrapType, HorzAlign, VertAlign
HInsertOLE: CLSID, ProgID, Width, Height, DisplayAsIcon (bool), IconPath
HEquation: String (equation LaTeX), BaseSize, FontName, LineMode
HInsertMemo: Text, Author, Date, Visible (bool)
HInsertEndnote: Text, NumberFormat, CustomMark
Find & Replace:
HFindReplace: FindString, ReplaceString, MatchCase (bool), WholeWord (bool), UseRegex (bool), Direction, Scope, ReplaceAll (bool), MatchByte (bool)
HFindDlg: FindString, Direction, Scope, ShowUI (bool)
HReplaceDlg: FindString, ReplaceString, Direction, Scope, ShowUI (bool)
Print & Export:
HPrint: Copies, Collate (bool), PrintRange (0=all, 1=current, 2=pages), PageRange, PrinterName, Duplex (0=none, 1=long, 2=short), Landscape (bool)
HExportPDF: filename, PageRange, ImageQuality (0-100), Encrypt (bool), Permission, OwnerPassword, UserPassword
HWaterMark: Text, FontName, FontSize, FontColor, Angle, Opacity, Position (0=center, 1=custom), ImagePath
Misc:
HAction: ActionName, Params
HCtrlCode: CtrlID, Properties
HLinkTextBox: SourceBox, TargetBox, LinkType
HMasterPage: PageName, PageIndex, ApplyTo
HMultiColumn: ColumnCount, ColumnGap, SameWidth (bool), LineBetween
HPresentation: SlideWidth, SlideHeight, Transition, Duration
HRevision: RevisionType, Author, Date, Comment
HTextArt: Text, Shape, FontName, FontStyle, CharSpacing, LineSpacing
HViewProperties: ViewMode, ZoomType, ZoomLevel, ShowRuler, ShowGrid
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Any HParameterSet name not covered by other tools params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hwp_selection_param_actionA
Execute HWP action with selection/navigation HParameterSet.
Supported param_set_name values and their key properties:
HSelectionOpt: SelectionType (0=normal, 1=block, 2=column), StartList, StartPara, StartPos, EndList, EndPara, EndPos
HGotoE: SetID (list index), ParaID (paragraph index), Pos (character offset), SubList, Direction (0=absolute, 1=relative)
HListParaPos: ListID, ParaID, Pos, SetID
HListProperties: ListType, ItemCount, StartNumber, NumFormat, Indent, Spacing, AlignType
HMousePos: X (screen x), Y (screen y), DocX (document x), DocY (document y), ListID, ParaID, CharPos
HScrollPosInfo: HScrollPos, VScrollPos, PageIndex, ZoomLevel, ViewMode (0=page, 1=continuous)
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Must be one of the selection param sets listed above params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hwp_shape_param_actionA
Execute HWP action with shape object HParameterSet.
Supported param_set_name values and their key properties:
HShapeCopyPaste: Direction (0=copy, 1=paste), OffsetX, OffsetY, KeepOriginal (bool), PasteSpecial
HShapeGuideLine: ShowGuideLine (bool), GuideLineColor, SnapDistance, HorizontalGuides (list), VerticalGuides (list)
HShapeObjComment: Comment, Author, Date, Visible (bool)
HShapeObject: Width, Height, Left, Top, Angle, HorzRelTo, VertRelTo, TreatAsChar (bool), TextWrap, ZOrder, Name, AltText
HShapeObjectCopyPaste: SrcObjID, DstPage, DstX, DstY, Scale (float), KeepOriginal (bool)
HShapeObjSaveAsPicture: ObjID, filename, Format (BMP|JPG|PNG|GIF|EMF), DPI, Quality
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Must be one of the shape param sets listed above params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hwp_style_param_actionA
Execute HWP action with style/border HParameterSet.
Supported param_set_name values and their key properties:
HStyle: Name, EngName, Type (0=paragraph, 1=character), BasedOn, NextStyle, LangId, CharShape, ParaShape
HStyleDelete: StyleName, ReplaceWith
HStyleItem: StyleName, StyleType, Properties (dict of style attributes)
HStyleTemplate: TemplatePath, ImportStyles (bool), ImportPageDef (bool), OverwriteExisting (bool)
HBorderFill: LeftBorder (type, width, color), RightBorder, TopBorder, BottomBorder, DiagonalBorder, FillType, FillColor, HatchStyle, GradType, ImagePath, ImageMode
HBorderFillExt: LeftBorder, RightBorder, TopBorder, BottomBorder, DiagonalBorder, FillType, FillColor, FillAlpha, HatchStyle, GradType, StartColor, EndColor, ImagePath, ImageMode, WaterMark (bool)
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Must be one of the style param sets listed above params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hwp_table_param_actionB
Execute HWP action with table-related HParameterSet.
Supported param_set_name values and their key properties:
HTableCreation: Cols, Rows, WidthType (0=auto, 1=fix, 2=relative), WidthValue, HeightType, HeightValue, CreateItemArray (cell definitions), TableProperties (sub-set), HeaderRow, ResizeUnit
HTable: Width, Height, CellMarginLeft, CellMarginRight, CellMarginTop, CellMarginBottom, BorderFill, CellSpacing, PageBreak, RepeatHeader
HCell: Width, Height, LeftMargin, RightMargin, TopMargin, BottomMargin, BorderFill, Editable, VertAlign (0=top, 1=center, 2=bottom), HasMargin
HCellBorderFill: CellIndex, BorderType, FillColor, FillType, HatchStyle, GradType, StartColor, EndColor, ImagePath, ImageMode
HTableBorderFill: BorderType, FillColor, FillType, ApplyTo
HTableChartInfo: ChartType, XAxisTitle, YAxisTitle, DataRange, LegendPosition, Is3D, ShowDataLabel
HTableDeleteLine: LineIndex, Direction (0=row, 1=col)
HTableDrawPen: PenType, PenWidth, PenColor
HTableInsertLine: LineIndex, Direction (0=row, 1=col)
HTableSplitCell: Rows, Cols, SplitMethod (0=equal, 1=proportional)
HTableStrToTbl: Delimiter, Rows, Cols, TableProperties
HTableSwap: Direction (0=row, 1=col)
HTableTblToStr: Delimiter, UseFirstRowAsHeader
HTableTemplate: TemplateName, AutoFit, HeaderRow
Args: doc_id: Document ID from open_document action_name: HWP action to execute param_set_name: Must be one of the table param sets listed above params: Properties to set on the param set
Inputs: doc_id (required), action_name (required), param_set_name (required), params. Returns: object
hyperlink_jumpC
Jump to a hyperlink target.
Args: doc_id: Document ID from open_document source: Source hyperlink identifier target: Target to jump to
Inputs: doc_id (required), source (required), target (required). Returns: object
import_styleC
Import a style into the document.
Args: doc_id: Document ID from open_document style: Style definition string to import
Inputs: style (required), doc_id (required). Returns: object
init_scanA
Initialize document scanning for text extraction.
option=0x0077(119) scans all text. Use with get_text/release_scan.
Args: doc_id: Document ID from open_document option: Scan option flags (default 119 = all text) range: Scan range (0=entire document)
Inputs: doc_id (required), range, option. Returns: object
insert_auto_numberC
Insert auto-numbering field.
Args: doc_id: Document ID from open_document num_type: Numbering type num_format: Number format (0=default) new_number: Optional starting number
Inputs: doc_id (required), num_type (required), new_number, num_format. Returns: object
insert_background_pictureC
Insert a background picture (mode: 0=tile, 1=center, 2=fill).
Inputs: doc_id (required), image_path (required), mode, target, +1 more. Returns: object
insert_bookmarkC
Insert a bookmark at current position.
Args: doc_id: Document ID from open_document name: Bookmark name command: Bookmark command (0=insert) type: Bookmark type
Inputs: name (required), doc_id (required), type, command. Returns: object
insert_cross_referenceC
Insert a cross-reference field.
Args: doc_id: Document ID from open_document command: Cross-reference command string
Inputs: doc_id (required), command (required). Returns: object
insert_fileC
Insert another file into the document.
Args: doc_id: Document ID from open_document file_path: Path to the file to insert
Inputs: doc_id (required), file_path (required). Returns: object
insert_form_controlC
Insert a form control (button, checkbox, combobox, edit, listbox).
Inputs: doc_id (required), control_type (required), name, width, +2 more. Returns: object
insert_hyperlinkB
Insert a hyperlink.
Args: doc_id: Document ID from open_document url: URL or link target text: Display text (defaults to url) direct_insert: 1 to insert directly
Inputs: url (required), doc_id (required), text, direct_insert. Returns: object
insert_index_markB
Insert an index mark entry.
Args: doc_id: Document ID from open_document first: Primary index term second: Optional secondary index term
Inputs: first (required), doc_id (required), second. Returns: object
insert_pictureC
Insert a picture into the document.
Inputs: doc_id (required), image_path (required), width, height, +2 more. Returns: object
insert_textC
Insert text at the current cursor position.
Args: doc_id: Document ID from open_document text: Text to insert
Returns: Insertion confirmation
Inputs: text (required), doc_id (required). Returns: object
is_action_enableB
Check if a HWP action is currently enabled.
Args: action: Action name to check (e.g. "Copy", "Paste", "Undo")
Inputs: action (required). Returns: object
is_command_lockB
Check if a command is locked.
Args: cmd: Command name to check
Inputs: cmd (required). Returns: object
list_open_documentsA
List all currently open documents.
Returns: List of open document summaries
Inputs: no named parameters. Returns: object
lock_commandB
Lock or unlock a HWP command.
Args: cmd: Command name to lock/unlock lock: True to lock, False to unlock
Inputs: cmd (required), lock (required). Returns: object
mail_mergeC
Execute mail merge operation.
Args: doc_id: Document ID from open_document action_params: Optional HMailMerge parameter overrides
Inputs: doc_id (required), action_params. Returns: object
make_table_of_contentsC
Generate table of contents.
Args: doc_id: Document ID from open_document action_params: Optional HTableOfContents parameter overrides
Inputs: doc_id (required), action_params. Returns: object
manage_styleB
Create, delete, or apply a named style.
Args: doc_id: Document ID from open_document action: "create", "delete", or "apply" style_name: Name of the style style_type: 0 = paragraph style, 1 = character style (for create) based_on: Base style name (for create)
Inputs: action (required), doc_id (required), based_on, style_name, +1 more. Returns: object
merge_table_cellsB
Merge a range of table cells.
Args: doc_id: Document ID from open_document table_index: Index of the table start_row: Starting row index start_col: Starting column index end_row: Ending row index (inclusive) end_col: Ending column index (inclusive)
Inputs: doc_id (required), end_col (required), end_row (required), start_col (required), +2 more. Returns: object
modify_field_propertiesC
Modify properties of a named field.
Args: doc_id: Document ID from open_document name: Field name property: Property name to modify value: New property value
Inputs: name (required), value (required), doc_id (required), property (required). Returns: object
move_cursorA
Move the cursor to a named position or raw MovePos ID.
Args: doc_id: Document ID from open_document position: Named position (doc_start, doc_end, para_start, para_end, line_start, line_end, next_para, prev_para, next_word, prev_word, next_char, prev_char, next_page, prev_page) move_id: Raw MovePos integer ID (advanced usage)
Inputs: doc_id (required), move_id, position. Returns: object
move_to_fieldB
Move cursor to a named field.
Args: doc_id: Document ID from open_document name: Field name get_text: Whether to get text start: Move to start of field select: Select the field content
Inputs: name (required), doc_id (required), start, select, +1 more. Returns: object
open_documentB
Open an HWP document for reading and editing.
Args: file_path: Path to the HWP file
Returns: Document info including doc_id and file name
Inputs: file_path (required). Returns: object
print_documentA
Print the document.
Args: doc_id: Document ID from open_document range: 0=all, 1=current page, 2=specified pages from_page: Start page (when range=2) to_page: End page (when range=2) copies: Number of copies printer_name: Target printer name collate: Collate copies
Inputs: doc_id (required), range, copies, collate, +3 more. Returns: object
put_field_textB
Set the text content of a named field.
Args: doc_id: Document ID from open_document name: Field name text: Text to set
Inputs: name (required), text (required), doc_id (required). Returns: object
register_moduleC
Register a module with HWP COM.
Args: name: Module name to register path: Optional file path for the module
Inputs: name (required), path. Returns: object
release_scanB
Release scan resources after InitScan.
Args: doc_id: Document ID from open_document
Inputs: doc_id (required). Returns: object
rename_fieldB
Rename a field.
Args: doc_id: Document ID from open_document old_name: Current field name new_name: New field name
Inputs: doc_id (required), new_name (required), old_name (required). Returns: object
replace_actionC
Replace one action handler with another.
Args: old_action: Action name to replace new_action: Replacement action name
Inputs: new_action (required), old_action (required). Returns: object
replace_textA
Replace all occurrences of text in the document.
Args: doc_id: Document ID from open_document old_text: Text to find new_text: Replacement text
Returns: Number of replacements made
Inputs: doc_id (required), new_text (required), old_text (required). Returns: object
rgb_colorA
Convert RGB or hex to HWP internal color value.
Inputs: b, g, r, hex. Returns: object
run_hwp_actionB
Execute an arbitrary HWP action (escape hatch for power users).
Args: doc_id: Document ID from open_document action_name: HWP action name (e.g., "SelectAll", "MoveDocBegin") params: Optional parameter dict for HAction.Execute param_set_name: Name of the HParameterSet to use
Returns: Action execution result
Inputs: doc_id (required), action_name (required), params, param_set_name. Returns: object
run_macroC
Execute or inspect HWP macros.
Args: doc_id: Document ID from open_document action: "run" (inline), "run_named" (by name), "get_source" script: Inline script text (for "run") name: Macro name (for "run_named"/"get_source") module: Module name (for "run_named")
Inputs: action (required), doc_id (required), name, module, +1 more. Returns: object
run_scriptB
Execute a HWP script macro directly.
Args: doc_id: Document ID from open_document script: Script source code to execute
Inputs: doc_id (required), script (required). Returns: object
save_as_imageC
Save document pages as image files.
Inputs: doc_id (required), output_path (required), dpi, format, +2 more. Returns: object
save_blockA
Save selected block to a file.
Args: doc_id: Document ID from open_document filename: Output file path format: File format ("HWP", "HWPX", "HTML", "TEXT", etc.) argument: Optional format-specific argument
Inputs: doc_id (required), filename (required), format, argument. Returns: object
save_documentA
Save the document.
Args: doc_id: Document ID from open_document output_path: Optional output path. If None, overwrites the original.
Returns: Save confirmation
Inputs: doc_id (required), output_path. Returns: object
save_document_asB
Save the document to a new file.
Args: doc_id: Document ID from open_document output_path: Output file path
Returns: Save confirmation with path
Inputs: doc_id (required), output_path (required). Returns: object
search_textC
Search for text in the document.
Args: doc_id: Document ID from open_document query: Text to search for case_sensitive: Whether the search is case sensitive
Returns: Number of matches found
Inputs: query (required), doc_id (required), case_sensitive. Returns: object
select_textC
Select a text range by start/end coordinates.
Args: doc_id: Document ID from open_document start_list: Start list number start_para: Start paragraph number start_pos: Start position end_list: End list number end_para: End paragraph number end_pos: End position
Inputs: doc_id (required), end_pos (required), end_list (required), end_para (required), +3 more. Returns: object
set_bullet_styleC
Apply bullet style to current paragraph.
Inputs: doc_id (required), size, character, bullet_type. Returns: object
set_captionA
Set caption on a table or image.
Args: doc_id: Document ID from open_document side: Caption position (0=below, 1=above, 2=left, 3=right) width: Caption width in hwpunits gap: Gap between object and caption cap_full_size: 1 to match object width
Inputs: doc_id (required), gap, side, width, +1 more. Returns: object
set_char_shapeC
Set extended character shape properties (spacing, ratio, shadow, outline, etc.).
Inputs: doc_id (required), properties (required). Returns: object
set_columnsC
Set multi-column layout for current section.
Inputs: doc_id (required), gap, count, column_type, +1 more. Returns: object
set_compatible_documentB
Set document compatibility mode.
Args: doc_id: Document ID from open_document target_program: Target program identifier (0=HWP) current_version: Optional version number for compatibility
Inputs: doc_id (required), target_program, current_version. Returns: object
set_current_field_nameC
Set the current field name at cursor position.
Args: doc_id: Document ID from open_document name: Field name to set option: Field option flags prev: Previous field name next: Next field name
Inputs: name (required), doc_id (required), next, prev, +1 more. Returns: object
set_cursor_positionC
Set cursor to a specific position.
Args: doc_id: Document ID from open_document list: List number para: Paragraph number pos: Position within paragraph
Inputs: pos (required), list (required), para (required), doc_id (required). Returns: object
set_drm_authorityC
Set DRM authority level.
Args: level: DRM authority level value
Inputs: level (required). Returns: object
set_drop_capA
Set drop cap (initial letter decoration) for paragraph.
Args: doc_id: Document ID from open_document style: Drop cap style (0=none, 1=embedded, 2=marginal) spacing: Spacing around drop cap in hwpunits face_name: Font face name face_color: Font color as HWP color value
Inputs: doc_id (required), style, spacing, face_name, +1 more. Returns: object
set_engine_propertiesC
Set HWP engine properties (spell check, auto-save, etc.).
Args: doc_id: Document ID from open_document action_params: HEngineProperties fields to set
Inputs: doc_id (required), action_params. Returns: object
set_field_ctrl_propertiesB
Set field control properties.
Args: doc_id: Document ID from open_document command: Field command string editable: 1=editable, 0=read-only field_dirty: 1=mark as modified user: User identifier string
Inputs: doc_id (required), user, command, editable, +1 more. Returns: object
set_file_securityB
Set file security — restrict copy/print.
Args: doc_id: Document ID from open_document password: Security password no_copy: 1 to disable copy no_print: 1 to disable print
Inputs: doc_id (required), no_copy, no_print, password. Returns: object
set_footnote_styleC
Configure footnote style (numbering, separator).
Inputs: doc_id (required), number_type, number_format, separator_type, +1 more. Returns: object
set_form_propertiesC
Set properties on the currently selected form control.
Inputs: doc_id (required), name, text, items, +2 more. Returns: object
set_hwp_propertyB
Set a property on HWP COM object.
Args: property_name: Property name to set value: Value to assign (string, int, or bool)
Inputs: value (required), property_name (required). Returns: object
set_master_pageC
Set master page settings for the section.
Args: doc_id: Document ID from open_document type: Master page type apply_to: Apply target (0=current section) front: Front page flag duplicate: Duplicate flag
Inputs: doc_id (required), type, front, apply_to, +1 more. Returns: object
set_message_box_modeA
Set message box display mode.
Use 0x00020000 to suppress all dialogs.
Args: mode: Message box mode flags
Inputs: mode (required). Returns: object
set_numbering_styleC
Apply numbering style to current paragraph.
Inputs: doc_id (required), level, start_number, numbering_type. Returns: object
set_page_borderC
Set page border and fill color.
Inputs: doc_id (required), fill_color, border_color, border_width. Returns: object
set_page_hidingC
Set page element hiding (header, footer, border, etc.).
Args: doc_id: Document ID from open_document fields: Bitmask of elements to hide
Inputs: doc_id (required), fields. Returns: object
set_page_numberC
Insert page number control.
Inputs: doc_id (required), format, position, start_number. Returns: object
set_page_num_ctrlB
Set page numbering control — restart page number.
Args: doc_id: Document ID from open_document page_starts_on: Page number to start on
Inputs: doc_id (required), page_starts_on. Returns: object
set_page_styleB
Set page style for the document.
Args: doc_id: Document ID from open_document orientation: "portrait" or "landscape" margin_top: Top margin in pt margin_bottom: Bottom margin in pt margin_left: Left margin in pt margin_right: Right margin in pt
Returns: Style confirmation
Inputs: doc_id (required), margin_top, margin_left, orientation, +2 more. Returns: object
set_paragraph_styleB
Set paragraph formatting for the current paragraph.
Args: doc_id: Document ID from open_document align: Text alignment ("left", "center", "right", "justify") line_spacing: Line spacing percentage (e.g., 160 = 160%)
Returns: Style confirmation
Inputs: doc_id (required), align, line_spacing. Returns: object
set_passwordC
Set document password.
Args: doc_id: Document ID from open_document password: Password string to set
Inputs: doc_id (required), password (required). Returns: object
set_pos_by_setC
Set cursor position using list/para/pos values.
Args: doc_id: Document ID from open_document list: List index para: Paragraph index pos: Position within paragraph
Inputs: pos (required), list (required), para (required), doc_id (required). Returns: object
set_section_definitionC
Set extended section definition (gutter, text flow, start page).
Inputs: doc_id (required), gutter_type, gutter_width, start_page_num, +1 more. Returns: object
set_tab_definitionC
Configure tab stops for current paragraph.
Inputs: doc_id (required), tab_stops. Returns: object
set_table_border_advA
Set border style for an entire table.
Args: doc_id: Document ID from open_document table_index: Index of the table border_width: Border width in pt border_color: Border color in hex border_style: Style ("solid", "dashed", "dotted", "double", "none") outer_only: Only set outer borders
Inputs: doc_id (required), table_index (required), outer_only, border_color, +2 more. Returns: object
set_table_cell_style_advB
Set advanced style for a table cell (background, alignment).
Args: doc_id: Document ID from open_document table_index: Index of the table row: Row index col: Column index background_color: Background color in hex (e.g., "#FFFF00") vertical_align: Vertical alignment ("top", "middle", "bottom")
Inputs: col (required), row (required), doc_id (required), table_index (required), +2 more. Returns: object
set_table_cell_textC
Set the text of a specific table cell.
Args: doc_id: Document ID from open_document table_index: Index of the table row: Row index col: Column index new_text: New text content
Returns: Update confirmation
Inputs: col (required), row (required), doc_id (required), new_text (required), +1 more. Returns: object
set_text_directionC
Set text direction (horizontal/vertical).
Args: doc_id: Document ID from open_document text_direction: 0=horizontal, 1=vertical landscape: Landscape mode flag
Inputs: doc_id (required), landscape, text_direction. Returns: object
set_text_fileC
Set text content in the document from a string.
Args: doc_id: Document ID from open_document data: Text data to set format: Format type ("TEXT", "HWPML", "HTML", etc.) option: Additional format option string
Inputs: data (required), doc_id (required), format, option. Returns: object
set_text_styleB
Set character formatting for the current selection.
Args: doc_id: Document ID from open_document font_name: Font name (e.g., "맑은 고딕") font_size: Font size in pt bold: Bold text italic: Italic text underline: Underline text color: Text color in hex (e.g., "#FF0000")
Returns: Style confirmation
Inputs: doc_id (required), bold, color, italic, +3 more. Returns: object
set_track_changesC
Configure track changes settings.
Args: doc_id: Document ID from open_document action_params: Optional HTrackChange parameter overrides
Inputs: doc_id (required), action_params. Returns: object
set_view_propertiesB
Set HWP view properties (zoom, view mode, etc.).
Args: doc_id: Document ID from open_document action_params: HViewProperties fields to set
Inputs: doc_id (required), action_params. Returns: object
set_watermarkC
Set a print watermark (text or image type).
Inputs: doc_id (required), text, angle, color, +4 more. Returns: object
sort_textA
Sort text in selection or document.
Args: doc_id: Document ID from open_document action_params: Optional HSort parameter overrides
Inputs: doc_id (required), action_params. Returns: object
spell_checkC
Run spell checker.
Args: doc_id: Document ID from open_document action_params: Optional HSpellCheck parameter overrides
Inputs: doc_id (required), action_params. Returns: object
split_table_cellB
Split a table cell into multiple cells.
Args: doc_id: Document ID from open_document table_index: Index of the table row: Row index of the cell col: Column index of the cell split_rows: Number of rows to split into split_cols: Number of columns to split into
Inputs: col (required), row (required), doc_id (required), table_index (required), +2 more. Returns: object
swap_table_row_colC
Swap table rows and columns.
Args: doc_id: Document ID from open_document type: Swap type (0=row↔col) swap_margin: Whether to swap margins too
Inputs: doc_id (required), type, swap_margin. Returns: object
table_to_textB
Convert a table to text.
Args: doc_id: Document ID from open_document table_index: Index of the table delimiter: Delimiter type ("tab", "comma", "space", "custom") custom_char: Custom delimiter character
Inputs: doc_id (required), table_index (required), delimiter, custom_char. Returns: object
text_to_tableC
Convert selected text to a table.
Args: doc_id: Document ID from open_document delimiter: Delimiter to detect ("tab", "comma", "space") num_cols: Number of columns
Inputs: doc_id (required), num_cols, delimiter. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 140 tools
There are several near-duplicate tools that an agent would struggle to distinguish, such as get_cursor_position vs get_pos_by_set, set_cursor_position vs set_pos_by_set, and run_script/run_macro/run_hwp_action. The six hwp_*_param_action tools plus hwp_misc_param_action overlap heavily with each other and with dedicated tools like set_page_style and set_header_footer.
The majority of tools follow a clear snake_case verb_noun convention (open_document, save_document, create_table, get_field_text), which makes the set largely predictable. A few legacy/internal-style names such as hwp_enum, get_pos_by_set, is_action_enable, and set_char_shape deviate, but they are the exception rather than the rule.
With 140 tools, this server is an extreme count mismatch; even the calibration's lowest category starts at 50+. The set is bloated by multiple generic param-action catch-alls and raw COM helper tools that could be consolidated into far fewer coherent operations.
The tool surface covers an impressively broad domain: document lifecycle, text, tables, fields, styles, forms, page layout, images, conversion, printing, and security. Minor gaps exist, such as no explicit create_new_document, no dedicated delete_table/delete_paragraph tool, and an over-reliance on raw escape-hatch actions for many operations, but agents can usually work around these.
Related MCP Connectors
Run saved PDF/office file flows, convert HWP/HWPX to Markdown or DOCX, and call data/text APIs.
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
File tools for your AI chat: PDF tables to Excel, merge PDFs, images to PDF, fill PDF forms.
中文工具:简繁转换、拼音、文本校对、Markdown↔Word/PDF/HTML 互转,供 Agent 自动调用。
Related MCP Servers
- AlicenseAqualityNot gradedmaintenanceEnables reading, editing, and creating Korean HWPX documents through python-hwpx library. Supports document creation, paragraph/table/image insertion, metadata management, and workspace-restricted file operations with automatic backup functionality.8MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to control Hancom's HWP/HWPX documents (Korean word processor) via COM interface on Windows, supporting creation, editing, formatting, and export.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to read and edit Korean HWP/HWPX documents, including converting Hanyang PUA old-Hangul characters to Unicode jamo, diagnosing unsupported characters, and preserving arae-a, panch'im, yet-ieung, expanded jamo, filler and side dots. Also supports HWPX search-and-replace, template filling, paragraph/table/image/style editing, page rendering to SVG/HTML, and creating new HWPX documents.1MIT
- AlicenseBqualityCmaintenanceEnables creating, editing, and reading Korean Hangul word-processor documents (.hwpx and .hwp) locally through Claude Desktop or VS Code, with no network or separate machine required. Provides tools for text, formatting, tables, images, charts, equations, footnotes, hyperlinks, and fields, and can export to PDF or convert .hwp files to .hwpx when Hangul is installed on Windows.22MIT