Word

Bookmark operations on an open document. bookmark(list, session_id) returns every bookmark with its name, paragraph index and a preview of the bookmarked text. bookmark(add, session_id, name="Intro", paragraph_index=2) bookmarks a paragraph; pass end_paragraph_index to span several paragraphs, or anchor_text to bookmark just a phrase inside the paragraph. bookmark(get-text, session_id, name="Intro") returns the full bookmarked text, which is the reliable way to re-read a passage after edits have shifted every index. bookmark(delete, session_id, name="Intro") removes the bookmark; the text stays. Bookmark names must start with a letter and may only contain letters, digits and underscores - Word rejects spaces and punctuation with an unhelpful error, so they are checked before the call reaches Word. Bookmarks survive edits elsewhere in the document, which makes them the stable way to refer to a passage across several calls.

Comment operations on an open document, the basis for review workflows. comment(list, session_id) returns every comment with its author, date, text and the document text it refers to. comment(add, session_id, paragraph_index=3, text='Please shorten this') attaches a comment to a whole paragraph; pass anchor_text to attach it to a phrase inside that paragraph instead. comment(resolve, session_id, index=1) marks a comment as done; pass resolved=false to reopen it. comment(delete, session_id, index=1) removes a comment. Comment indexes are 1-based and shift after every delete, so when removing several comments work from the highest index downwards. Paragraph indexes come from paragraph(list).

Document-level operations. document(get-info, session_id) returns word/page/paragraph/table counts. document(get-properties|set-properties, session_id, title=..., author=...) reads or writes metadata. document(export-pdf, session_id, output_path='C:\\...\\report.pdf') writes a PDF without changing the document. document(save-as, session_id, output_path='C:\\...\\copy.rtf') saves a copy; the format follows the extension (.docx, .docm, .doc, .pdf, .rtf, .txt, .html) and the open document is saved as part of the operation.

Field operations on an open document. field(insert-toc, session_id, lower_heading_level=3) inserts a table of contents at the top and fills it immediately. It stays EMPTY unless paragraphs use heading styles, so apply 'Heading 1'/'Heading 2' via paragraph(add, style=...) first; the result reports entry_count. field(insert-page-number, session_id, position='footer', alignment='center', include_total_pages=true) adds page numbers to every section. field(update-toc, session_id) refreshes the table of contents after content changed. field(update-all, session_id) refreshes every field including headers and footers. field(list, session_id) returns type, code and current result of each field.

File and session management — the FIRST tool of every workflow. WORKFLOW: file(open, path='C:\\...\\report.docx') -> use session_id with document/text/paragraph/table tools -> file(close, save=true). NEW FILES: file(create, path='C:\\...\\new.docx') creates the file AND starts a session. REUSE: call file(list) first — if the document is already open, reuse its session_id. The file must be CLOSED in the Word desktop app; COM requires exclusive access. show=true makes Word visible. timeout_seconds: max time per operation (default 300).

Header and footer operations on an open document. Headers belong to a SECTION, not to the document, so use section(list) first when a document has more than one. header-footer(set, session_id, kind='footer', text='Confidential') writes the same text to every section; pass section_index to target one. type='first-page' or 'even-pages' switches the matching section option on automatically, because Word otherwise stores the text without ever showing it. Writing to a section whose header is inherited from the previous one breaks that link. header-footer(get, session_id, kind='header') reads the text back. For page numbers use field(insert-page-number) instead, which inserts live fields.

Inline image operations on an open document. image(list, session_id) returns index, size and alt text of every image. image(insert, session_id, image_path='C:/pics/chart.png', width=300, caption='Figure 1') appends an image; pass paragraph_index to place it before a specific paragraph. image(resize, session_id, index=1, scale_percent=50) or (index=1, width=200) resizes. image(replace, session_id, index=1, image_path=...) swaps the picture but keeps position and size. image(delete|set-alt-text, session_id, index=1, ...) edits an existing image. Sizes are in points (1 point = 1/72 inch), not pixels. All indexes are 1-based. Only inline images are covered, not floating shapes.

Bullet and numbered list operations on an open document. list(apply, session_id, start_index=2, end_index=5, list_type='number') turns a range of paragraphs into a numbered list; list_type can be bullet, number or outline-number. list(set-level, session_id, start_index=3, end_index=4, level=2) indents paragraphs to a sub-level; levels run from 1 to 9 and only outline-number lists render a distinct format per level. list(restart, session_id, start_index=6) starts the numbering over at that paragraph, which is how two separate numbered lists are kept apart. list(remove, session_id, start_index=2, end_index=5) strips the list formatting again. list(get, session_id) reports the list formatting of every paragraph, including the bullet or number Word renders. Paragraph indexes are 1-based and shift whenever paragraphs are added or removed, so read them with paragraph(list) right before using them. Omitting end_index applies the action to start_index alone.

Paragraph operations on an open document. paragraph(list, session_id, skip=0, take=200) returns index, text, style, alignment and outline level. paragraph(add, session_id, text='...', style='Heading 1') appends a paragraph. paragraph(insert, session_id, index=3, text='...') inserts before paragraph 3. paragraph(delete|set-style|set-alignment, session_id, index=3, ...) edits an existing paragraph. Indexes are 1-based and shift after add, insert or delete — re-run list before further edits.

Tracked change operations on an open document. revision(list, session_id) returns every tracked change with its type, author, date and affected text, plus whether tracking is currently on. revision(accept, session_id) accepts every change; pass index=1 to accept a single one. revision(reject, session_id, index=2) discards a change the same way. revision(set-tracking, session_id, enabled=true) turns change tracking on or off, which is what makes later edits show up as revisions in the first place. Revision indexes are 1-based and shift after every accept or reject, so when handling several changes individually work from the highest index downwards, or just accept or reject them all at once. Accepting or rejecting everything also covers headers and footers, which Word's own AcceptAllRevisions does not.

Renders a page of an open document as a PNG image. screenshot(page, session_id) renders page 1; pass page=3 for another page. Use this to check the layout visually - page breaks, table widths, image placement and header positions are far easier to judge from the rendered page than from measurements. The image is written to a file and the path is returned. Pass include_image=true to also get the PNG inline as base64, which is only worth it when the image is actually going to be looked at, since it is large. dpi defaults to 150, which is readable without being wasteful; 96 is enough for a rough layout check and 300 approaches print quality. Rendering goes through a PDF export of the single page, so unsaved changes are included.

Section operations on an open document. A section owns the page setup and the headers and footers, so changing margins or orientation for part of a document means adding a section first. section(list, session_id) returns index, start type, margins, page size and orientation. section(add, session_id, start_type='next-page', paragraph_index=...) inserts a section break after that paragraph, or at the end when omitted. section(page-setup, session_id, section_index=2, orientation='landscape', top_margin=72) changes one section; without section_index it changes the whole document. ALL MEASUREMENTS ARE IN POINTS: 72 pt = 1 inch = 2.54 cm.

Style operations on an open document. Styles keep formatting consistent without touching every piece of text. style(list, session_id) returns only the styles the document actually uses; pass in_use_only=false for the complete list, which is over 370 entries on a localized Word. style(create, session_id, name='Callout', style_type='paragraph', base_style='Normal') adds a custom style. style(modify, session_id, name='Callout', font_name='Calibri', font_size=11, bold=true, color='#C00000', alignment='center', space_after=12) changes formatting; omitted properties stay as they are. style(delete, session_id, name='Callout') removes a custom style; built-in styles cannot be deleted. LOCALIZED NAMES: Word reports styles under localized names, so a German Word calls 'Heading 1' 'Ueberschrift 1'. Built-in styles are addressable by their English name; list returns both, and english_name is the one to send back. Sizes and spacing are in points (72 pt = 1 inch).

Table operations on an open document. table(list, session_id) returns index, size and style of every table. table(create, session_id, rows=3, columns=4, style='Table Grid') appends a table. table(read, session_id, index=1) returns all cell values as rows. table(set-cell, session_id, index=1, row=1, column=2, text='Total') writes one cell. table(add-row, session_id, index=1, values=['a','b']) appends a filled row. table(delete-row|set-style, session_id, index=1, ...) edits an existing table. All indexes are 1-based.

Text operations on an open document. text(get, session_id) returns the full text; add start/end to read a character range. text(append, session_id, text='...') appends a paragraph at the end. text(find, session_id, text='term') returns match positions and context. text(replace, session_id, text='old', replace_text='new') replaces occurrences. text(format, session_id, start=0, end=20, bold=true, color='#0078D4') formats a character range. Positions are Word character offsets as reported by get and find.