Keynote MCP Server

Returns all content on a specific slide including title, body, text items, images, shapes, tables, and presenter notes.

Returns a structured summary of the entire presentation including name, slide count, theme, and per-slide summaries with titles, body text, item counts, and presenter notes.

Designs a complete slide with automatic layout, typography, and color based on content and optional brand settings

Designs multiple slides at once with automatic layout variety and consistent branding

Sets brand configuration for subsequent design_slide and design_deck operations. Values persist until changed or cleared.

Gets current brand configuration from the active Keynote theme, merged with any previously set brand overrides

Lists all available slide layouts with descriptions, categories, and element details

Lists all available presentation templates with slide counts and descriptions

Gets the full structure of a specific presentation template with slide-by-slide layout and content hints

Creates a full presentation from a template, using the template's layout sequence with provided content

Exports the frontmost Keynote presentation as a PDF file

Exports all slides of the frontmost presentation as individual image files to a directory

Exports the frontmost Keynote presentation as a Microsoft PowerPoint (.pptx) file

Adds an image file to a slide at a given position with optional width and height

Replaces an existing image on a slide with a new image file

Removes an image from a slide

Lists all images on a slide with position, size, and file name info

Repositions and/or resizes an existing image on a slide

Sets the presenter notes for a specific slide

Gets the presenter notes for a specific slide

Returns presenter notes for all slides as an array of {slideIndex, notes}

Creates a new blank Keynote presentation. Optionally specify a theme name.

Opens a Keynote presentation (.key file) by file path.

Saves the frontmost Keynote presentation. Optionally specify a file path for save-as.

Closes the frontmost Keynote presentation.

Lists all currently open Keynote presentations with their names and file paths.

Returns slide count, theme name, dimensions, and file path for a presentation. Defaults to the frontmost presentation.

Adds a shape to a slide with specified type, position, size, and optional fill colour

Removes a shape from a slide

Lists all shapes on a slide with position and size information

Modifies a shape's position, size, fill colour, border colour, or border width

Adds a new slide to the frontmost presentation. Optionally specify position and master slide name.

Removes a slide by its 1-based index from the frontmost presentation.

Duplicates a slide by its 1-based index in the frontmost presentation.

Moves a slide from one position to another in the frontmost presentation.

Returns the total number of slides in the frontmost presentation.

Returns an array of all slides in the frontmost presentation with index, title text, and layout name.

Lists all available master slide (layout) names for the current theme of the frontmost presentation.

Starts the slideshow of the frontmost Keynote presentation. Optionally start from a specific slide.

Stops the currently running Keynote slideshow.

Advances to the next slide or build during an active Keynote slideshow.

Goes back to the previous slide or build during an active Keynote slideshow.

Jumps to a specific slide during an active Keynote slideshow.

Returns whether a slideshow is currently playing and the current slide number.

Adds a table to a slide with the specified number of rows and columns

Sets the value of a specific cell in a table on a slide

Bulk-sets table data from a 2D array of strings. Each inner array is a row.

Reads all data from a table and returns it as a 2D array of strings

Removes a table from a slide

Sets the title text of a slide

Sets the body text of a slide

Adds a new text box to a slide at a specified position and size

Updates the text content of an existing text item on a slide

Removes a text item from a slide

Lists all text items on a slide with their content, position, and size

Formats a text item with font, size, color, bold, italic, and alignment options

Lists available Keynote themes. Attempts to query Keynote directly; falls back to a curated list of standard themes.

Applies a theme to the current Keynote presentation. This changes the document theme, updating master slides and default styling.

Sets a solid background color on a slide. Provide a hex color string like '#FF0000' for red.

Sets an image file as the background of a slide. The image file must be accessible on the local filesystem.

Gets the master slide (layout) name for a given slide.

Changes the master slide (layout) of a slide. The master name must match one of the available master slides in the current theme.

Sets the transition effect for a slide. Common effects: 'none', 'magic move', 'dissolve', 'push', 'reveal', 'cube', 'flip', 'wipe', 'shimmer', 'sparkle'. Use list_transition_types to see all available effects.

Gets the current transition effect, duration, and delay for a slide.

Returns a list of all available Keynote slide transition effect names. These can be used with the set_slide_transition tool.

Adds a build-in or build-out animation to an item on a slide. Build-in animations play when the item appears; build-out animations play when it exits.

Removes a build-in or build-out animation from an item on a slide.

Lists all build-in and build-out animations for every item on a given slide.