Skip to main content
Glama
HWP MCP Server
by mjyoo2

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.server

Claude 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_document

Open HWP document

close_document

Close document

list_open_documents

List open documents

save_document

Save document

save_document_as

Save as different name/format

Read (5)

Tool

Description

get_document_text

Extract full text

get_paragraphs

Get paragraph list

get_tables

Get table list

get_table_data

Get table data (2D array)

search_text

Search text

Write (5)

Tool

Description

replace_text

Replace text

insert_text

Insert text

set_table_cell_text

Set table cell text

append_paragraph

Append paragraph

set_text_file

Set document content from text data

Formatting (3)

Tool

Description

set_text_style

Character formatting (font, size, bold, color, etc.)

set_paragraph_style

Paragraph formatting (alignment, line spacing)

set_page_style

Page formatting (margins, orientation)

Table (3)

Tool

Description

create_table

Create table

add_table_row

Add table row

delete_table_row

Delete table row

Advanced (5)

Tool

Description

run_hwp_action

Execute arbitrary HWP action (power user)

convert_to_hwpx

Convert HWP → HWPX

convert_to_pdf

Convert HWP → PDF

batch_convert_files

Batch convert files (HWP, PDF, DOCX, etc.)

set_file_security

File security settings (copy/print restriction)

Cursor & Navigation (11)

Tool

Description

move_cursor

Move cursor to specified position

get_cursor_position

Get current cursor position

set_cursor_position

Set cursor position (list, para, pos)

get_pos_by_set

Get cursor position as set

set_pos_by_set

Set cursor position from set

get_selected_pos_by_set

Get selection start/end positions

select_text

Select text range by coordinates

get_selection_info

Get current selection info

clear_selection

Clear selection

delete_selection

Delete selected content

init_scan

Initialize document scan

Field (12)

Tool

Description

create_field

Create named field (template placeholder)

field_exists

Check if field exists

get_field_list

Get all field names

get_field_text

Read field text

put_field_text

Set field text

get_current_field

Get field name at cursor

set_current_field_name

Set current field name

move_to_field

Move cursor to field

rename_field

Rename field

modify_field_properties

Modify field properties

set_field_ctrl_properties

Set field control properties

batch_fill_fields

Batch fill multiple fields

Advanced Table (11)

Tool

Description

add_table_column

Add table column

delete_table_column

Delete table column

merge_table_cells

Merge cells

split_table_cell

Split cell

set_table_cell_style_adv

Cell style (background, vertical alignment)

set_table_border_adv

Table border style

table_to_text

Table → text conversion

text_to_table

Text → table conversion

swap_table_row_col

Swap table rows/columns

apply_table_template

Apply table template

Enhanced Formatting (5)

Tool

Description

set_char_shape

Extended character properties (kerning, spacing, shadow, etc.)

set_bullet_style

Bullet style

set_numbering_style

Numbering style

set_tab_definition

Tab stops

manage_style

Create/delete/apply styles

Page & Section (10)

Tool

Description

set_section_definition

Section definition (binding margin, text flow)

set_page_border

Page border and background

set_columns

Multi-column layout

set_page_number

Page number

set_header_footer

Header/footer

set_footnote_style

Footnote style

set_master_page

Master page

set_page_hiding

Hide page elements (header/footer, etc.)

set_page_num_ctrl

Page number control (restart numbering)

set_text_direction

Text direction (horizontal/vertical)

Image & Equation (3)

Tool

Description

insert_picture

Insert picture

insert_background_picture

Insert background picture

create_equation

Insert equation

Form Control (3)

Tool

Description

insert_form_control

Insert form control (button, checkbox, etc.)

set_form_properties

Set form control properties

get_form_data

Read form data

Document Info (5)

Tool

Description

get_document_info

Document metadata (page count, modified state)

get_document_summary

Document summary (title, author)

get_page_text

Extract specific page text

get_page_count

Total page count

export_page_as_image

Export page as image

Print & Export (3)

Tool

Description

print_document

Print document

set_watermark

Set watermark (text/image)

save_as_image

Save document as image

Utility (4)

Tool

Description

convert_units

Unit conversion (mm, pt, hwpunit)

rgb_color

RGB/Hex → HWP color value

run_macro

Run HWP macro

get_file_info

File metadata (without opening)

Tool

Description

insert_bookmark

Insert bookmark

insert_hyperlink

Insert hyperlink

hyperlink_jump

Jump to hyperlink target

insert_index_mark

Insert index mark

insert_auto_number

Insert auto number field

insert_cross_reference

Insert cross reference

Header/Footer & Caption (2)

Tool

Description

set_drop_cap

Drop cap (decorative first letter)

set_caption

Table/image caption

Document Operations (8)

Tool

Description

sort_text

Sort text

spell_check

Spell check

set_track_changes

Track changes

mail_merge

Mail merge

make_table_of_contents

Generate table of contents

insert_file

Insert another file

set_password

Document password

save_block

Save selection to file

Compatibility & Settings (3)

Tool

Description

set_compatible_document

Document compatibility mode

set_view_properties

HWP view properties (zoom, view mode, etc.)

set_engine_properties

HWP engine properties (spell check, auto-save, etc.)

Control & Object (4)

Tool

Description

delete_ctrl

Delete selected control

find_ctrl

Find control

check_x_object

Check X object existence

release_scan

Release scan resources

Style & Script (4)

Tool

Description

import_style

Import style

export_style

Export style

run_script

Run HWP script

get_script_source

Get script source

System & Security (11)

Tool

Description

register_module

Register COM module

set_drm_authority

DRM authority

lock_command

Lock/unlock command

is_command_lock

Check command lock status

set_message_box_mode

Message box mode

get_message_box_mode

Get message box mode

is_action_enable

Check action enabled

replace_action

Replace action handler

get_hwp_property

Get HWP COM property

set_hwp_property

Set HWP COM property

hwp_enum

String → HWP enum value

HParameterSet Actions (10)

Tool

Description

HParameterSet Count

hwp_table_param_action

Table actions

14

hwp_file_param_action

File actions

11

hwp_draw_param_action

Draw object actions

22

hwp_shape_param_action

Shape actions

6

hwp_style_param_action

Style/border actions

6

hwp_form_param_action

Form actions

13

hwp_doc_info_param_action

Document info actions

9

hwp_hanja_param_action

Hanja/conversion actions

11

hwp_selection_param_action

Selection/position actions

6

hwp_misc_param_action

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.toml

Development

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 tools
add_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

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_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

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

    C2.7/5.0

    Scored across 140 tools

    Disambiguation1/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      Not graded
      maintenance
      Enables 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.
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to control Hancom's HWP/HWPX documents (Korean word processor) via COM interface on Windows, supporting creation, editing, formatting, and export.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      22
      MIT