Actions are tasks your AI agent can perform through this integration, such as creating, finding, or updating items.
Add an image as slide background using full-slide picture workaround. Requires the current presentation file and image file in the 'files' parameter. Since python-pptx doesn't support true background images, this adds a full-size image that covers the entire slide. Add other content AFTER using this action so elements appear on top of the background image. Returns the updated presentation file.
Add a new blank slide to an existing presentation. Requires the current presentation file in the 'files' parameter. Only blank slides are supported - all slides are created without any predefined layout or placeholders. Use other actions like add_text, add_image, or add_bullet_list to add content to the slide. Returns the updated presentation file.
Create a chart in a slide. Requires the current presentation file in the 'files' parameter. Returns the updated presentation file.
UNIFIED action for adding content to slides from markdown. Supports TWO MODES: (1) GRANULAR MODE: Provide array of elements with optional positions for precise control. (2) AUTO-LAYOUT MODE: Provide single markdown document for automatic vertical flow layout. Element types are auto-detected from markdown. Supports text, tables, bullets, headings (H1-H6), blockquotes, code blocks. This is the PRIMARY and RECOMMENDED way to add content to slides. Perfect for AI agents.
Insert an image into a slide from uploaded files. Provide the image file in the 'files' parameter - the first image file found will be used. Supports PNG, JPG, JPEG, GIF, and BMP formats.
Create a new PowerPoint presentation with optional template. If template files (*.pptx) are provided in the 'files' parameter, the first template found will be used. Otherwise, a blank presentation is created. If title/subtitle are provided (in markdown format), they will be added as text boxes on a blank slide with automatically calculated font sizes to ensure text fits. Supports inline markdown formatting: **bold**, *italic*, __underline__, `code`. Only blank slides are supported - all slides are created without predefined layouts or placeholders. Returns a unique presentation_id for use with other actions and the complete presentation file for stateless operation.
Remove a shape, text box, image, chart, or any other element from a slide by its index position. Requires the current presentation file in the 'files' parameter. Use this to delete unwanted elements like text boxes, pictures, charts, tables, or any other shapes that were previously added to the slide. Shape indices are 0-based and correspond to the order elements were added. Returns the updated presentation file.
Find and replace text across entire presentation. Preserves template formatting (bullets, indentation, colors, structure). Replacement text is plain text - markdown is NOT parsed. If placeholder contains formatting metadata (e.g., [Title, Bold=true]), corresponding markdown characters are automatically stripped from replacement text to prevent literal **/** appearing. USE forced_font_size parameter ONLY if template placeholder contains 'Fontsize=XXpt'. Otherwise omit it - font size auto-calculates or extracts from placeholder metadata. SAFETY: Blocks replacements if multiple matches found without replace_all=true. RESPONSE: Includes status, summary (requested/successful/failed/blocked counts), and changes array (detailed changelog with locations and applied formatting).
Extract comprehensive styling information from any slide element (text box, table, image, chart, etc.) in a token-optimized format perfect for LLM analysis. Returns compressed styling descriptions that include patterns, formatting, and recreation instructions. Ideal for template analysis and element replication. Requires the current presentation file in the 'files' parameter.
Get detailed information about elements on a slide or entire presentation. SINGLE SLIDE MODE: Provide slide_index to get elements for that specific slide. ALL SLIDES MODE: Omit slide_index to get elements for all slides with summary statistics. Content is automatically included for elements with detected problems (boundary violations, overlaps). Use the include_content parameter only when you need to see content for elements that have no issues. Requires the current presentation file in the files parameter. Elements are listed in the order they appear on the slide, with index numbers that correspond to the delete_element action.
Reposition or resize elements, and update table cells by row/column coordinates. DOES NOT support general text replacement - use find_and_replace for that instead. USE THIS ONLY FOR: (1) Changing element position/size (left, top, width, height), (2) Updating specific table cells by row/column index. DO NOT USE for text replacement - find_and_replace is more efficient. Use get_slide_elements to find element indices. Requires the current presentation file in the 'files' parameter. Returns the updated presentation file.
Reset slide background to inherit from master/layout. Requires the current presentation file in the 'files' parameter. Returns the updated presentation file.
Set a solid color background for a slide. Requires the current presentation file in the 'files' parameter. Returns the updated presentation file.
Set a gradient background for a slide. Requires the current presentation file in the 'files' parameter. Returns the updated presentation file.
Set the vertical alignment for text within a shape. Requires the current presentation file in the 'files' parameter. Returns the updated presentation file.
Set automatic text sizing behavior for a text box or shape. Requires the current presentation file in the 'files' parameter. Use TEXT_TO_FIT_SHAPE to prevent text overflow by automatically reducing font size to fit within the shape boundaries. Use SHAPE_TO_FIT_TEXT to expand the shape to accommodate all text. Returns the updated presentation file.
Set the margins for a text box or shape. Requires the current presentation file in the 'files' parameter. Returns the updated presentation file.