Read PowerPoint Deck
ppt_readRead PowerPoint content without changing the file: slide text, tables, chart data, notes, comments, links, equations, media, transitions and animations, with anchors for follow-up edits.
Instructions
Read slide content: the anchored deck view, deck and slide facts, text, find, elements, links, tables, chart data, notes, comments, equations, media, transitions and animations. Never changes a file. Audits and checks are ppt_inspect; to change anything use ppt_edit, ppt_graphics, ppt_tables, ppt_design, ppt_review or ppt_deck. Operations, one per line, as name: what it does:
get_presentation_view: Read the deck as an anchored markdown view with shape and table-cell anchors; the cheap first read, and apply_edits takes its anchors.
get_presentation_info: Read deck-level facts: slide count and size, slide order with ids and titles, masters, layouts and sections.
get_slide_info: Read one slide in depth: layout, hidden flag, and every shape with its id, kind, geometry and text preview.
get_text: Read the deck's text in reading order, optionally with speaker notes; pages in whole slides.
find_text: Find text deck-wide or in scope (slides, a range, or slide_numbers from 1), exact case unless match_case=false; each match gives its slide, shape, paragraph and character offsets for edits.
list_elements: List one kind of element (slides, shapes, placeholders, tables, charts, images, layouts, ...) with ids and locations.
list_hyperlinks: List every link and click action on shapes, text, tables, notes, SmartArt, layouts and masters, broken ones flagged.
get_table: Read one table in full: cell text, merge regions, column widths and row heights, with 0-based addresses.
get_chart_data: Read what a chart holds: series names, categories, values and axis titles, from the chart's cached values.
get_notes: Read one slide's speaker notes with their paragraph and run structure, to edit without losing formatting.
extract_text: Read all slide text and every slide's speaker notes in one call; pages by slide.
list_comments: List every comment, modern threads with replies and legacy comments, with the ids the comment operations take. More operations follow, in the same format, in the op parameter's description.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | The operation to run: one listed in this tool's description, or one of these, in the same format: - list_equations: List every equation in slides, tables and notes with its location and characters. - get_media_playback: Read how an embedded video or audio plays: start, loop, rewind, mute, volume and full screen. - get_transitions: Read each slide's transition: kind, direction, speed, duration and advance settings. - list_animations: Read one slide's animations in play order, with effects this server does not write counted separately. - get_server_info: Report product, edition, version, tool and operation totals, platform and Python; needs no deck. - get_workflows: List task recipes, or return one recipe's ordered steps naming the exact tool and operation. | |
| args | No | The operation's arguments as an object, including file_path unless the operation names other paths or reads no deck; unknown keys are refused. Slides count from 1 in slide_number and from 0 in slide: the user's slide 2 is slide_number 2 or slide 1. ppt_help lists every argument. |