Keynote MCP Server
Provides full programmatic control over Apple Keynote, enabling creation, editing, presenting, and exporting of Keynote presentations through natural language.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Keynote MCP Server create a new presentation using the pitch-deck template"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Keynote MCP Server
A Model Context Protocol (MCP) server that provides full programmatic control over Apple Keynote through AppleScript and JXA (JavaScript for Automation). Designed for use with Claude Desktop and any MCP-compatible client, this server lets you create, edit, present, and export Keynote presentations entirely through natural language.
Prerequisites
macOS (any recent version with Keynote installed)
Apple Keynote (free from the Mac App Store)
Node.js 18+ (check with
node --version)Accessibility permissions -- your terminal or IDE must be allowed to control Keynote via System Settings > Privacy & Security > Accessibility
Related MCP server: Keynote-MCP
Installation
git clone https://github.com/superdwayne/keynoteMP.git keynote-mcp-server
cd keynote-mcp-server
npm install
npm run buildVerify the build succeeds and types pass:
npx tsc --noEmitClaude Desktop Configuration
Add the following entry to your claude_desktop_config.json (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"keynote": {
"command": "node",
"args": ["/absolute/path/to/keynote-mcp-server/dist/index.js"]
}
}
}Replace /absolute/path/to/keynote-mcp-server with the actual path on your machine. Restart Claude Desktop after saving the configuration.
Tool Reference
The server registers 70 tools across 13 modules. All slide indices are 1-based.
Design Engine (8 tools)
The Design Engine automates professional slide composition with a brand-aware system including 23+ layouts, typography scaling, color harmonies, and presentation templates.
Tool | Parameters | Description |
|
| Composes a complete slide with automatic layout, typography, and color |
|
| Composes multiple slides with consistent branding and layout variety |
|
| Sets brand configuration for subsequent design operations |
| -- | Extracts brand configuration from the active Keynote theme |
|
| Lists all available slide layouts with descriptions and element details |
| -- | Lists all presentation templates with slide counts |
|
| Gets full structure of a template with content hints |
|
| Creates a full presentation from a template |
Available layouts: title-center, title-left, title-bold, section-break, section-gradient, content-left, content-right-image, content-left-image, two-column, three-column, full-image, image-grid, quote, statistic, comparison, closing-cta, closing-thankyou, blank-canvas, timeline, before-after, team-grid, pricing-table, roadmap
Available templates: pitch-deck (10 slides), status-update (5 slides), workshop (8 slides), product-launch (7 slides)
Brand styles: minimal, bold, elegant, playful, corporate
Presentation Management (6 tools)
Tool | Parameters | Description |
|
| Creates a new blank Keynote presentation, optionally with a named theme |
|
| Opens an existing |
|
| Saves the frontmost presentation; provide a path for save-as |
|
| Closes the frontmost presentation |
| -- | Lists all open presentations with names and file paths |
|
| Returns slide count, theme, dimensions, and path for a presentation |
Slide Management (7 tools)
Tool | Parameters | Description |
|
| Adds a new slide at a given position with an optional layout |
|
| Removes a slide by index |
|
| Duplicates a slide at the given index |
|
| Moves a slide from one position to another |
| -- | Returns total number of slides |
| -- | Returns all slides with index, title, and layout name |
| -- | Lists available master slide / layout names for the current theme |
Text Content (7 tools)
Tool | Parameters | Description |
|
| Sets the title text of a slide |
|
| Sets the body text of a slide |
|
| Adds a text box with optional brand-aware typography via |
|
| Updates text content of an existing text item |
|
| Removes a text item from a slide |
|
| Lists all text items on a slide with content, position, and size |
|
| Applies formatting to a text item |
Images & Media (5 tools)
Tool | Parameters | Description |
|
| Adds an image with optional role-based sizing |
|
| Replaces an existing image with a new file |
|
| Removes an image from a slide |
|
| Lists all images on a slide with positions and file names |
|
| Repositions or resizes an existing image |
Presenter Notes (3 tools)
Tool | Parameters | Description |
|
| Sets presenter notes for a slide |
|
| Retrieves presenter notes for a slide |
| -- | Returns all slides' presenter notes as an array |
Themes & Styling (6 tools)
Tool | Parameters | Description |
| -- | Lists available Keynote themes (queries Keynote or falls back to a built-in list) |
|
| Applies a theme to the frontmost presentation |
|
| Sets a solid background color on a slide |
|
| Sets an image as the slide background |
|
| Returns the master slide / layout name for a slide |
|
| Changes a slide's master layout |
Transitions & Animations (6 tools)
Tool | Parameters | Description |
|
| Sets a transition effect on a slide |
|
| Returns current transition settings for a slide |
| -- | Lists all 33 available transition effect names |
|
| Adds a build-in or build-out animation to an item |
|
| Removes an animation from an item |
|
| Lists all build animations for every item on a slide |
Tables & Charts (6 tools)
Tool | Parameters | Description |
|
| Adds a table to a slide |
|
| Sets the value of a specific table cell |
|
| Bulk-sets table data from a 2D array |
|
| Reads all data from a table as a 2D array |
|
| Removes a table from a slide |
|
| Adds a chart to a slide (may fall back to a data table due to AppleScript limitations) |
Live Slideshow Control (6 tools)
Tool | Parameters | Description |
|
| Starts the slideshow from the beginning or a specific slide |
| -- | Stops the currently running slideshow |
| -- | Advances to the next slide or build |
| -- | Goes back to the previous slide or build |
|
| Jumps to a specific slide during the slideshow |
| -- | Returns whether a slideshow is playing and the current slide number |
Export (4 tools)
Tool | Parameters | Description |
|
| Exports the presentation as a PDF |
|
| Exports all slides as individual image files to a directory |
|
| Exports as Microsoft PowerPoint (.pptx) |
|
| Exports a single slide as an image file |
Content Extraction (2 tools)
Tool | Parameters | Description |
|
| Returns all content on a slide: title, body, text items, images, shapes, tables, and notes |
| -- | Returns a structured summary of the entire presentation with per-slide details |
Shapes & Drawing (4 tools)
Tool | Parameters | Description |
|
| Adds a shape with optional brand-aware color via |
|
| Removes a shape from a slide |
|
| Lists all shapes on a slide with position and size |
|
| Modifies a shape's position, size, or styling |
Usage Examples
Design a pitch deck from a template
"Create a pitch deck for my startup using the pitch-deck template with our brand colors #2563EB and an elegant style."Claude will call set_brand, then design_from_template with "pitch-deck", generating all 10 slides with coordinated layouts, typography, and transitions.
Design a single slide with brand-aware styling
"Design slide 3 with the title 'Market Opportunity', body text about the TAM, and use the statistic layout."Claude will call design_slide with the content and layout name, automatically applying brand colors and typography.
Create a presentation from scratch
"Create a new Keynote presentation with the Gradient theme, add 5 slides, and set titles for each one."Claude will call create_presentation, then add_slide five times, and set_slide_title for each slide.
Build a data-driven slide
"On slide 3, add a table with quarterly revenue data: Q1: $1.2M, Q2: $1.5M, Q3: $1.8M, Q4: $2.1M."Claude will use add_table, then set_table_data to populate the cells.
Export for sharing
"Export my presentation as a PDF to the Desktop and also save each slide as a PNG image."Claude will call export_to_pdf and export_to_images with the appropriate paths.
Add brand-aware text and shapes
"Add a heading with role 'display' on slide 1 that says 'Welcome'."Claude will call add_text_item with role: "display", which automatically applies brand-aware font, size, and color with WCAG-compliant contrast.
Architecture
keynote-mcp-server/
src/
index.ts # Entry point -- creates MCP server, registers all tool modules
applescript.ts # AppleScript/JXA execution bridge (runAppleScript, runJXA)
tools/
presentation.ts # create, open, save, close, list, info
slides.ts # add, delete, duplicate, move, count, list, layouts
text.ts # title, body, text items, formatting (brand-aware via role)
images.ts # add, replace, delete, list, reposition (role-based sizing)
notes.ts # set, get, get-all presenter notes
theme.ts # themes, backgrounds, master slides
transitions.ts # slide transitions, build animations
tables-charts.ts # tables (CRUD + bulk data), charts
slideshow.ts # start, stop, next, previous, go-to, status
export.ts # PDF, images, PowerPoint, single-slide export
content.ts # read slide content, full presentation summary
shapes.ts # add, delete, list, update shapes (brand-aware via role)
design.ts # design_slide, design_deck, set_brand, get_brand, list_layouts,
# list_templates, get_template, design_from_template
design/
tokens.ts # Design tokens (spacing, margins, canvas sizes)
color.ts # Color math, harmonies, WCAG contrast
typography.ts # Type scale system (8 roles, modular scale)
grid.ts # 12-column, 8-row grid system
layouts.ts # Layout definition schema
layout-library.ts # 23+ pre-built slide layouts
brand.ts # Brand configuration, theme extraction
brand-state.ts # Shared brand state across all tool modules
balance.ts # Visual balance and whitespace utilities
accents.ts # Decorative accent generation
variations.ts # Layout variation engine (mirror, shift, toggle)
composer.ts # Slide/deck composition orchestration
templates.ts # Presentation templates (pitch-deck, status-update, etc.)
progress.ts # Progress indicators for multi-slide decks
dist/ # Compiled JavaScript output (generated by `npm run build`)
package.json
tsconfig.jsonThe server uses stdio transport (standard for local MCP servers). Each tool module exports a register*Tools(server) function that registers tools with the MCP server instance. All Keynote automation is performed by shelling out to osascript via child_process.execFile, using either AppleScript or JXA depending on the operation.
Troubleshooting
"AppleScript error: Not authorized to send Apple events"
Your terminal or IDE needs Accessibility permissions. Go to System Settings > Privacy & Security > Accessibility and add your terminal application (Terminal.app, iTerm2, VS Code, etc.).
You may also need to grant permissions under Privacy & Security > Automation to allow your terminal to control Keynote.
"Keynote got an error: Can't get document 1"
No Keynote presentation is currently open. Use create_presentation or open_presentation first.
Build errors
Make sure you have Node.js 18+ installed and run npm install before npm run build. The project requires TypeScript and the MCP SDK as dependencies.
Keynote must be installed
This server controls Keynote.app via AppleScript. It will not work without Keynote installed. Keynote is free from the Mac App Store.
Chart creation limitations
Direct chart creation via AppleScript is limited in some Keynote versions. The add_chart tool will attempt to create a chart directly but may fall back to creating a data table with your values. You can then manually convert that table to a chart in Keynote.
Timeout errors
Each AppleScript command has a 30-second timeout. Operations on very large presentations or complex exports may occasionally time out. If this happens, try the operation again or work with fewer slides at a time.
License
MIT
Available Tools
70 toolsadd_build_animationC
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.
Inputs: type (required), buildType (required), itemIndex (required), slideIndex (required), +1 more.
add_chartA
Adds a chart to a slide. Note: Keynote's AppleScript support for charts is limited. This creates a chart and attempts to set the chart type. Data series configuration may require manual adjustment in Keynote due to AppleScript limitations.
Inputs: chartType (required), slideIndex (required), x, y, +3 more.
add_imageB
Adds an image file to a slide at a given position with optional width and height
Inputs: filePath (required), slideIndex (required), x, y, +3 more.
add_shapeB
Adds a shape to a slide with specified type, position, size, and optional fill colour
Inputs: x (required), y (required), width (required), height (required), +4 more.
add_slideB
Adds a new slide to the frontmost presentation. Optionally specify position and master slide name.
Inputs: position, masterSlideName.
add_tableC
Adds a table to a slide with the specified number of rows and columns
Inputs: rows (required), columns (required), slideIndex (required), x, +3 more.
add_text_itemA
Adds a new text box to a slide at a specified position and size
Inputs: x (required), y (required), text (required), width (required), +4 more.
apply_themeA
Applies a theme to the current Keynote presentation. This changes the document theme, updating master slides and default styling.
Inputs: themeName (required).
change_slide_masterA
Changes the master slide (layout) of a slide. The master name must match one of the available master slides in the current theme.
Inputs: masterName (required), slideIndex (required).
close_presentationB
Closes the frontmost Keynote presentation.
Inputs: saving.
create_presentationB
Creates a new blank Keynote presentation. Optionally specify a theme name.
Inputs: themeName.
delete_imageB
Removes an image from a slide
Inputs: imageIndex (required), slideIndex (required).
delete_shapeB
Removes a shape from a slide
Inputs: shapeIndex (required), slideIndex (required).
delete_slideA
Removes a slide by its 1-based index from the frontmost presentation.
Inputs: slideIndex (required).
delete_tableB
Removes a table from a slide
Inputs: slideIndex (required), tableIndex (required).
delete_text_itemC
Removes a text item from a slide
Inputs: itemIndex (required), slideIndex (required).
design_deckB
Designs multiple slides at once with automatic layout variety and consistent branding
Inputs: slides (required), style, addAccents, primaryColor.
design_from_templateA
Creates a full presentation from a template, using the template's layout sequence with provided content
Inputs: templateName (required), style, slides, primaryColor, +1 more.
design_slideB
Designs a complete slide with automatic layout, typography, and color based on content and optional brand settings
Inputs: slideIndex (required), body, quote, stats, +10 more.
duplicate_slideA
Duplicates a slide by its 1-based index in the frontmost presentation.
Inputs: slideIndex (required).
export_slide_to_imageA
Exports a single slide as an image file. Exports all slides to a temporary directory, then copies the specific slide image to the target path.
Inputs: filePath (required), slideIndex (required), format.
export_to_imagesB
Exports all slides of the frontmost presentation as individual image files to a directory
Inputs: directoryPath (required), format.
export_to_pdfB
Exports the frontmost Keynote presentation as a PDF file
Inputs: filePath (required).
export_to_pptxA
Exports the frontmost Keynote presentation as a Microsoft PowerPoint (.pptx) file
Inputs: filePath (required).
format_textB
Formats a text item with font, size, color, bold, italic, and alignment options
Inputs: itemIndex (required), slideIndex (required), bold, color, +4 more.
get_all_presenter_notesA
Returns presenter notes for all slides as an array of {slideIndex, notes}
Inputs: no named parameters.
get_brandA
Gets current brand configuration from the active Keynote theme, merged with any previously set brand overrides
Inputs: no named parameters.
get_full_presentation_contentA
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.
Inputs: no named parameters.
get_presentation_infoA
Returns slide count, theme name, dimensions, and file path for a presentation. Defaults to the frontmost presentation.
Inputs: name.
get_presenter_notesA
Gets the presenter notes for a specific slide
Inputs: slideIndex (required).
get_slide_contentA
Returns all content on a specific slide including title, body, text items, images, shapes, tables, and presenter notes.
Inputs: slideIndex (required).
get_slide_countA
Returns the total number of slides in the frontmost presentation.
Inputs: no named parameters.
get_slide_layout_namesA
Lists all available master slide (layout) names for the current theme of the frontmost presentation.
Inputs: no named parameters.
get_slide_masterA
Gets the master slide (layout) name for a given slide.
Inputs: slideIndex (required).
get_slideshow_statusA
Returns whether a slideshow is currently playing and the current slide number.
Inputs: no named parameters.
get_slide_transitionA
Gets the current transition effect, duration, and delay for a slide.
Inputs: slideIndex (required).
get_table_dataA
Reads all data from a table and returns it as a 2D array of strings
Inputs: slideIndex (required), tableIndex (required).
get_templateA
Gets the full structure of a specific presentation template with slide-by-slide layout and content hints
Inputs: templateName (required).
go_to_slideA
Jumps to a specific slide during an active Keynote slideshow.
Inputs: slideIndex (required).
list_build_animationsA
Lists all build-in and build-out animations for every item on a given slide.
Inputs: slideIndex (required).
list_imagesA
Lists all images on a slide with position, size, and file name info
Inputs: slideIndex (required).
list_layoutsA
Lists all available slide layouts with descriptions, categories, and element details
Inputs: category.
list_presentationsA
Lists all currently open Keynote presentations with their names and file paths.
Inputs: no named parameters.
list_shapesA
Lists all shapes on a slide with position and size information
Inputs: slideIndex (required).
list_slidesA
Returns an array of all slides in the frontmost presentation with index, title text, and layout name.
Inputs: no named parameters.
list_templatesA
Lists all available presentation templates with slide counts and descriptions
Inputs: no named parameters.
list_text_itemsB
Lists all text items on a slide with their content, position, and size
Inputs: slideIndex (required).
list_themesA
Lists available Keynote themes. Attempts to query Keynote directly; falls back to a curated list of standard themes.
Inputs: no named parameters.
list_transition_typesA
Returns a list of all available Keynote slide transition effect names. These can be used with the set_slide_transition tool.
Inputs: no named parameters.
move_slideB
Moves a slide from one position to another in the frontmost presentation.
Inputs: toIndex (required), fromIndex (required).
next_slideA
Advances to the next slide or build during an active Keynote slideshow.
Inputs: no named parameters.
open_presentationA
Opens a Keynote presentation (.key file) by file path.
Inputs: filePath (required).
previous_slideA
Goes back to the previous slide or build during an active Keynote slideshow.
Inputs: no named parameters.
remove_build_animationA
Removes a build-in or build-out animation from an item on a slide.
Inputs: buildType (required), itemIndex (required), slideIndex (required).
replace_imageB
Replaces an existing image on a slide with a new image file
Inputs: filePath (required), imageIndex (required), slideIndex (required).
save_presentationA
Saves the frontmost Keynote presentation. Optionally specify a file path for save-as.
Inputs: filePath.
set_brandA
Sets brand configuration for subsequent design_slide and design_deck operations. Values persist until changed or cleared.
Inputs: style, accentColor, fontPrimary, primaryColor, +3 more.
set_image_positionA
Repositions and/or resizes an existing image on a slide
Inputs: imageIndex (required), slideIndex (required), x, y, +2 more.
set_presenter_notesB
Sets the presenter notes for a specific slide
Inputs: notes (required), slideIndex (required).
set_slide_background_colorB
Sets a solid background color on a slide. Provide a hex color string like '#FF0000' for red.
Inputs: color (required), slideIndex (required).
set_slide_background_imageA
Sets an image file as the background of a slide. The image file must be accessible on the local filesystem.
Inputs: filePath (required), slideIndex (required).
set_slide_bodyB
Sets the body text of a slide
Inputs: text (required), slideIndex (required).
set_slide_titleB
Sets the title text of a slide
Inputs: text (required), slideIndex (required).
set_slide_transitionA
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.
Inputs: effect (required), slideIndex (required), duration.
set_table_cellC
Sets the value of a specific cell in a table on a slide
Inputs: row (required), value (required), column (required), slideIndex (required), +1 more.
set_table_dataB
Bulk-sets table data from a 2D array of strings. Each inner array is a row.
Inputs: data (required), slideIndex (required), tableIndex (required).
start_slideshowA
Starts the slideshow of the frontmost Keynote presentation. Optionally start from a specific slide.
Inputs: fromSlide.
stop_slideshowA
Stops the currently running Keynote slideshow.
Inputs: no named parameters.
update_shapeB
Modifies a shape's position, size, fill colour, border colour, or border width
Inputs: shapeIndex (required), slideIndex (required), x, y, +5 more.
update_text_itemB
Updates the text content of an existing text item on a slide
Inputs: text (required), itemIndex (required), slideIndex (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 70 tools
Most tools have distinct purposes, but some overlap exists between high-level design tools (design_deck, design_slide, design_from_template) and between get_full_presentation_content and get_presentation_info. Despite 70 tools, boundaries are mostly clear.
Predominantly uses verb_noun pattern (add_slide, delete_image), but inconsistencies exist: 'list' vs 'get' for similar operations (list_slides vs get_slide_count), and 'change_slide_master' vs 'set_slide_background_color'. Minor mix of 'format_text' instead of 'set_text_formatting'.
70 tools is excessive for an MCP server, far beyond the typical 10-20. While comprehensive, many tools (e.g., multiple design functions, separate list/get variants) could be consolidated. The high number risks overwhelming agents and increasing selection errors.
Covers nearly all aspects of Keynote automation: creation, editing, formatting, animations, transitions, exporting, slideshow control, and branding. Minor gaps exist (chart support is limited, no audio/video/hyperlink tools), but the surface is remarkably complete for a presentation tool.
Maintenance
Related MCP Connectors
Create, edit, export and manage presentations. Requires a paid PPT.AI API merchant account.
Create, edit, preview and export designed, editable presentations from a brief or outline.
Generate AI slide decks and export native PowerPoint (.pptx) and PDF presentations from chat.
Create and edit presentations with your AI, preview slides, open them in the Decktype editor.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to control Apple Keynote presentations through AppleScript automation, supporting comprehensive slide creation, management, and content operations.97 PyPI82MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to control Keynote presentations through AppleScript automation, supporting slide operations, theme-aware content management, and export functions.11MIT
- FlicenseAqualityCmaintenanceLocal macOS MCP server that reads, edits, and exports Apple Keynote presentations via JXA. Enables Claude to visually analyze slides, apply design changes, and iterate on presentations directly.191-
- AlicenseNot gradedqualityDmaintenanceEnables creating, reading, and modifying Google Slides presentations programmatically via natural language through the Model Context Protocol.191ISC