Read a Word document and extract content, comments, and track changes.

Args: path: Path to the .docx file include_text: Include full document text (default: True) include_comments: Include comments with anchors (default: True) include_track_changes: Include insertions/deletions (default: True)

Returns: Dictionary containing: - metadata: Document metadata (path, author, created, modified, word_count) - paragraphs: List of paragraphs with index, text, and style - comments: List of comments with id, author, date, text, anchor_text, anchor_paragraph, resolved (boolean), and replies - track_changes: List of track changes with id, type (insertion/deletion), author, date, text, paragraph

Search for text in a Word document.

Use this to find specific content without loading the entire document. Returns matching paragraphs with surrounding context.

Args: path: Path to the .docx file query: Text to search for case_sensitive: Match case exactly (default: False) context_paragraphs: Paragraphs to include before/after each match (default: 1) max_results: Maximum matches to return (default: 20) include_annotations: Include comments/track changes on matched paragraphs (default: False)

Returns: Dictionary containing: - query: The search query - case_sensitive: Whether search was case-sensitive - total_matches: Total matches found - matches_returned: Number returned (may be limited) - matches: List with paragraph_index, paragraph_text, paragraph_style, match_start, match_end, context_before, context_after, and optionally comments and track_changes

Get a specific range of paragraphs from a Word document.

Use after search_document to get more context around matches, or to read a specific section without loading the full document.

Args: path: Path to the .docx file start_index: First paragraph index (0-based, inclusive) end_index: Last paragraph index (0-based, inclusive) include_annotations: Include comments/track changes in range (default: False)

Returns: Dictionary containing: - start_index: Actual start (may be clamped) - end_index: Actual end (may be clamped) - total_paragraphs: Total paragraphs in document - paragraphs: List with index, text, style - comments: Comments in range (if include_annotations=True) - track_changes: Track changes in range (if include_annotations=True)

Add a comment anchored to specific text in a Word document.

Args: path: Path to the .docx file anchor_text: Text to anchor the comment to (must exist and be unique in document) comment_text: The comment content author: Comment author name (default: "Claude") output_path: Save to new file; if omitted, creates timestamped backup and overwrites original

Returns: Dictionary containing: - success: True if successful - comment_id: ID of the created comment - anchored_to: The text the comment is anchored to - paragraph: Index of the paragraph containing the anchor - output_path: Path where the file was saved

Errors: - If anchor text is not found: {"success": false, "error": "Anchor text not found in document"} - If anchor text appears multiple times: {"success": false, "error": "Anchor text appears N times; provide more context for unique match"}

Add a reply to an existing comment in a Word document.

Args: path: Path to the .docx file parent_comment_id: ID of the comment to reply to reply_text: The reply content author: Reply author name (default: "Claude") output_path: Save to new file; if omitted, creates timestamped backup and overwrites original

Returns: Dictionary containing: - success: True if successful - reply_id: ID of the created reply - parent_comment_id: ID of the parent comment - output_path: Path where the file was saved

Make an edit with track changes enabled (insertion, deletion, or replacement).

Args: path: Path to the .docx file find_text: Text to find and modify (must exist and be unique) replace_with: Replacement text (use empty string for deletion-only) author: Change author name (default: "Claude") output_path: Save to new file; if omitted, creates timestamped backup and overwrites original

Returns: Dictionary containing: - success: True if successful - change_type: "replacement", "deletion", or "insertion" - original_text: The text that was changed - new_text: The replacement text - paragraph: Index of the paragraph containing the change - output_path: Path where the file was saved

Mark a comment as resolved/done.

Args: path: Path to the .docx file comment_id: ID of the comment to resolve output_path: Save to new file; if omitted, creates timestamped backup and overwrites original

Returns: Dictionary containing: - success: True if successful - comment_id: ID of the resolved comment - output_path: Path where the file was saved

Accept a tracked change (apply the change permanently).

For insertions: The inserted text becomes part of the document. For deletions: The deleted text is permanently removed.

Args: path: Path to the .docx file change_id: ID of the track change to accept output_path: Save to new file; if omitted, creates timestamped backup and overwrites original

Returns: Dictionary containing: - success: True if successful - change_id: ID of the accepted change - change_type: "insertion" or "deletion" - output_path: Path where the file was saved

Reject a tracked change (undo the change).

For insertions: The inserted text is removed. For deletions: The deleted text is restored.

Args: path: Path to the .docx file change_id: ID of the track change to reject output_path: Save to new file; if omitted, creates timestamped backup and overwrites original

Returns: Dictionary containing: - success: True if successful - change_id: ID of the rejected change - change_type: "insertion" or "deletion" - output_path: Path where the file was saved