Word MCP Live

Add or manage hyperlinks in a Word document. Finds the specified text and converts it to a clickable hyperlink with blue underline.

Merge multiple Word documents into a single target document.

Merge cells in a rectangular area of a table.

Merge cells horizontally in a single row.

Merge cells vertically in a single column.

Add password protection to a Word document.

Reject tracked changes: remove insertions and restore deleted text. Optionally filter by author or specific change IDs.

Replace all content between start_anchor_text and end_anchor_text (or next logical header if not provided).

Reemplaza el bloque de párrafos debajo de un encabezado, evitando modificar TOC.

Search for text and replace all occurrences.

Set page layout (orientation, size, margins) for a document section.

Set paragraph spacing (before/after/line) for one or a range of paragraphs. line_spacing_rule: single, 1.5_lines, double, exactly, at_least, multiple.

Set text alignment for all cells in a table.

Set text alignment for a specific table cell.

Set padding/margins for a specific table cell.

Apply shading/filling to a specific table cell.

Set the width of a specific table column.

Set the widths of multiple table columns.

Set the overall width of a table.

Mark text content as deleted (tracked deletion). This changes TEXT CONTENT only — it does not change formatting. Args: filename: Path to Word document. text: Text to mark as deleted. author: Author name for the tracked change. Returns: JSON string with result

Insert text content after a specific string, marked as a tracked insertion. This changes TEXT CONTENT only — it does not change formatting. Args: filename: Path to Word document. after_text: Text to search for; new text is inserted right after this. insert_text: Text to insert. author: Author name for the tracked change. Returns: JSON string with result

Replace text content with tracked changes (marks old as deleted, new as inserted). This changes TEXT CONTENT only — it does not change formatting (font, highlight, style). To change formatting, use word_live_format_text instead. Args: filename: Path to Word document. old_text: Text to find and mark as deleted. new_text: Replacement text to insert (must differ from old_text). author: Author name for the tracked change. Returns: JSON string with result

Remove password protection from a Word document.

Validate all footnotes in document for coherence and compliance. Returns detailed report on ID conflicts, orphaned content, missing styles, etc.

Verify document protection and/or digital signature.

[Windows only] Accept tracked changes in a Word document open in Word. Filter by author or specific revision IDs. Requires Word running.

[Windows only] Add a named bookmark at a paragraph in a Word document open in Word. Paragraph is 1-indexed. Requires Word running.

[Windows only] Add a comment to a Word document open in Word. Specify start/end character positions or paragraph_index (1-indexed). Requires Word running.

[Windows only] Add header and/or footer to a section in a Word document open in Word. Requires Word running.

[Windows only] Add page numbers to header or footer in a Word document open in Word. Requires Word running.

[Windows only] Add a section break (new_page, continuous, even_page, odd_page) to a Word document open in Word. Requires Word running.

[Windows only] Add a table to a Word document open in Word. Optionally provide data as 2D list. Default style is 'Table Grid' with autofit to window width. Set style=None for no style, autofit=None for legacy fixed behavior. Requires Word running.

[Windows only] Add a diagonal text watermark to a Word document open in Word. Requires Word running.

[Windows only] Apply or remove bullet/numbered/multilevel list formatting on paragraphs. Args: filename: Document name or path (None = active document). start_paragraph: First paragraph to format (1-indexed, required). end_paragraph: Last paragraph to format (1-indexed, defaults to start_paragraph). list_type: "bullet", "number", or "multilevel" (outline numbered). level: Indentation level (0 = first level, 1 = second level, etc.). For multilevel, this sets the list level per paragraph. remove: If True, removes list formatting from the range. continue_previous: If True, continues numbering from a previous list above. number_format: (multilevel only) Dict mapping level (int) to format string. Example: {1: "%1.", 2: "%1.%2."} → "5.", "5.1." Keys are 1-indexed levels. If not provided, defaults to {1: "%1.", 2: "%1.%2."}. start_at: (multilevel only) Dict mapping level (int) to starting number. Example: {1: 5} → numbering starts at 5. If not provided, starts at 1. track_changes: Track changes as revisions. Returns: JSON with result info.

[Windows only] Delete text from a Word document open in Word. Specify start/end character positions. Requires Word running.

[Windows only] Scan an open Word document for common layout problems. Performs a single-pass scan of all paragraphs and reports issues that cause unexpected layout behavior (empty pages, content pushed to wrong page, etc.). Checks performed: 1. keep_with_next chains: 5+ consecutive paragraphs with keep_with_next=true push content to the next page as a block (severity: high). 2. Heading styles on body text: Heading style on paragraphs >100 chars (medium). 3. PageBreakBefore on non-headings: may cause unexpected blank space (medium). 4. Manual page break count: ^m characters found via Find (info). 5. Style summary: count of paragraphs per style, flags if >50% use Heading styles. Args: filename: Document name or path (None = active document). Returns: JSON with issues array, style_summary dict, and issue_count.

[Windows only] Find text in a Word document open in Word. Returns positions and context. With use_wildcards=True, supports ^m (page break), ^t (tab), ^p (paragraph mark) and Word wildcards. context_chars controls how many characters of surrounding context to return (default 60). Requires Word running.

Format a table in an open Word document via COM. Supports border removal, cell formatting, column sizing, and table alignment. Use table_index=-1 for the last table, 1 for the first, etc. Args: filename: Document name or path (None = active document). table_index: 1-based table index, or -1 for the last table. border_style: Border style for all edges: "none", "single", "double", "dotted", "dashed", "thick". "none" removes all borders. cell_bold: List of [row, col, bold] entries (1-indexed) to set bold on cell text. Example: [[1, 1, true], [1, 2, true]] bolds row 1 cells. cell_alignment: List of [row, col, alignment] entries. alignment: "left", "center", "right", "justify". Row 0 = all rows, Col 0 = all cols. column_widths: List of column widths in points (1-indexed order). Example: [200, 200] sets col 1 to 200pt, col 2 to 200pt. table_alignment: Table alignment on page: "left", "center", "right". cell_shading: List of [row, col, color_hex] entries. color_hex as "#RRGGBB". Row 0 = all rows. Example: [[1, 0, "#DDDDDD"]] shades entire row 1. autofit: "window" (fit to page width), "content" (fit to cell content), "fixed" (fixed column widths). Returns: JSON with result info.

[Windows only] Format text in an open Word document: font, color, highlight, style, alignment, page breaks. Use this tool for any visual/formatting change that does NOT alter the text content itself. Two addressing modes (provide one): - start/end: Character positions (from word_live_find_text or word_live_get_page_text). - start_paragraph/end_paragraph: 1-indexed paragraph range (from word_live_get_text etc.). Args: filename: Document name or path (None = active document). start: Start character position. end: End character position. start_paragraph: First paragraph index (1-indexed). Alternative to start/end. end_paragraph: Last paragraph index (1-indexed, defaults to start_paragraph). bold: Set bold (True/False). italic: Set italic (True/False). underline: Set underline (True/False). font_name: Font family (e.g., "Arial", "Times New Roman"). font_size: Font size in points (e.g., 12). font_color: Text color as "#RRGGBB" hex (e.g., "#FF0000" for red). highlight_color: Text highlight background color index. 0 = remove highlight, 1 = black, 2 = blue, 3 = turquoise, 4 = bright green, 5 = pink, 6 = red, 7 = yellow, 8 = white, 9 = dark blue, 10 = teal, 11 = green, 12 = violet, 13 = dark red, 14 = dark yellow, 15 = gray, 16 = light gray. Common: 7=yellow (add), 0=none (remove). style_name: Apply a named Word style (e.g., "Heading 1", "Normal"). paragraph_alignment: Paragraph alignment — "left" (0), "center" (1), "right" (2), "justify" (3). Applies to ALL paragraphs in the selected range. page_break_before: Set or clear PageBreakBefore on paragraphs in range (True/False). preserve_direct_formatting: When True and style_name is set, saves font/size/bold/italic/ alignment/spacing before applying the style and restores them after. Useful for changing a paragraph's style (e.g., Heading 5 → Normal) without losing its visual formatting. track_ch…

[Windows only] Get all comments from a Word document open in Word. Requires Word running.

[Windows only] Get document info (pages, words, sections, etc.) from a Word document open in Word. Requires Word running.

[Windows only] Get text from specific page(s) of an open Word document. Returns paragraphs on the requested page(s) with char_start/char_end offsets that can be passed directly to word_live_format_text, word_live_delete_text, etc. Uses Word's GoTo API to find page boundaries. For long legal documents, this is much more efficient than reading all paragraphs. Args: filename: Document name or path (None = active document). page: Page number to read (1-indexed, required). end_page: Last page to read (inclusive). If None, reads only `page`. Returns: JSON with paragraphs list, each containing index, text, char_start, char_end.

[Windows only] Inspect paragraph formatting properties for diagnostics. Returns detailed formatting info for each paragraph in the range. Essential for debugging layout issues like unexpected page breaks (caused by keep_with_next chains), broken list formatting, wrong styles, or inconsistent fonts. Per-paragraph fields returned: index, text_preview (first 80 chars), char_start, char_end, style, font_name, font_size, bold, italic, alignment, space_before_pt, space_after_pt, line_spacing, line_spacing_rule, page_break_before, keep_with_next, keep_together. Also: list_type, list_level, list_string (if paragraph is in a list), highlight_color. When include_runs=True, each paragraph also includes a "runs" array with per-run formatting: text, bold, italic, font_name, font_size. Consecutive words with identical formatting are grouped into a single run. Useful for detecting which specific words are bold/italic (e.g., bold sub-clause numbers in otherwise normal text). Args: filename: Document name or path (None = active document). start_paragraph: First paragraph (1-indexed, required). end_paragraph: Last paragraph (1-indexed, defaults to start_paragraph). include_runs: Include per-run (word-level) formatting detail (default False). Returns: JSON with formatting details per paragraph.

[Windows only] Get all text from a Word document open in Word, paragraph by paragraph. Requires Word running.

[Windows only] Get the undo stack from a Word document open in Word. Shows MCP tool operations as named entries. Requires Word running.

[Windows only] Insert text into a Word document that is open in Word. Position: 'start', 'end', 'cursor', or character offset. Requires Word running.

[Windows only] List all tracked changes (revisions) in a Word document open in Word. Requires Word running.

[Windows only] Modify a table in an open Word document. Operations: get_info, set_cell, add_column, delete_column, add_row, delete_row, merge_cells, autofit. All row/col indices are 1-based (Word COM standard). Args: filename: Document name or path (None = active document). table_index: 1-based table index (default 1). operation: One of: get_info, set_cell, add_column, delete_column, add_row, delete_row, merge_cells, autofit. row: Row index for set_cell, delete_row. col: Column index for set_cell, delete_column. text: Text for set_cell. before_row: Insert row before this index (add_row). None = append at end. before_col: Insert column before this index (add_column). None = append at end. header: Header text for new column (add_column, placed in row 1). cells: List of cell values for new row/column. start_row: Start row for merge_cells. start_col: Start column for merge_cells. end_row: End row for merge_cells. end_col: End column for merge_cells. autofit_mode: 'content', 'window', or 'fixed' (autofit operation). track_changes: Track modifications as revisions. Returns: JSON with operation result.

[Windows only] Reject tracked changes in a Word document open in Word. Filter by author or specific revision IDs. Requires Word running.

[Windows only] Find and replace text in an open Word document. Uses Word's native Find & Replace, which works across tracked change boundaries (unlike manual delete+insert). Supports Word special characters when use_wildcards=True: ^m (manual page break), ^t (tab), ^p (paragraph mark), and Word wildcard syntax. Args: filename: Document name or path (None = active document). find_text: Text to find. With use_wildcards=True, supports ^m, ^t, ^p and Word wildcards. replace_text: Replacement text. Use "" to delete matches. match_case: Case-sensitive search. match_whole_word: Match whole words only (ignored when use_wildcards=True). use_wildcards: Enable Word wildcards and special characters. replace_all: Replace all occurrences (True) or just the first one (False). track_changes: Track replacements as revisions. Returns: JSON with count of replacements made.