Skip to main content
Glama

Keynote-MCP

by betancur
MIT License
  • Apple

Keynote-MCP

A Model Context Protocol (MCP) server that enables AI assistants to control Keynote presentations through AppleScript automation.

🎉 This is an enhanced fork featuring modular architecture, theme-aware content management, and comprehensive documentation improvements.

Features

  • Presentation Management: Create, open, save, close presentations
  • Slide Operations: Add, delete, duplicate, move slides
  • Theme-Aware Content: Professional content placement using Keynote's design elements
  • Modular Architecture: Maintainable codebase with specialized AppleScript modules
  • Export Functions: Screenshots, PDF export

Quick Setup

  1. Clone the repository
    git clone https://github.com/betancur/keynote-mcp.git cd keynote-mcp
  2. Install dependencies
    pip install -r requirements.txt
  3. Grant macOS permissions
    • System Preferences > Security & Privacy > Privacy
    • Add Terminal and Python to Accessibility permissions
    • Add Python to Automation permissions for Keynote
  4. Configure Claude Desktop Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
    { "mcpServers": { "keynote": { "command": "python3", "args": ["/path/to/keynote-mcp/mcp_server.py"] } } }
  5. Test the server
    python3 test_server.py

Note: Make sure Keynote is installed and you have appropriate permissions for automation.

Available Tools (26 total)

Presentation Management

  • create_presentation - Create new presentation
  • open_presentation - Open existing presentation
  • save_presentation - Save presentation
  • close_presentation - Close presentation

Slide Operations

  • add_slide - Add new slide
  • delete_slide - Delete slide
  • duplicate_slide - Copy slide
  • move_slide - Reorder slides

Content Management

  • add_text_box - Add text to slide
  • add_image - Add image to slide
  • set_slide_content - 🆕 Set content using theme elements (recommended)
  • get_slide_default_elements - 🆕 Check available theme elements

Export & Capture

  • screenshot_slide - Take slide screenshot
  • export_pdf - Export as PDF

Theme-Aware Features

Our latest update includes theme-aware content management that uses Keynote's built-in design elements for professional-looking presentations with consistent styling.

📚 Documentation

Comprehensive documentation is available in the docs/ directory:

💡 Usage Examples

# Create new presentation result = await call_tool("create_presentation", { "name": "My Presentation" }) # Add slide with theme-aware content result = await call_tool("add_slide", { "title": "Welcome", "layout": "Title & Content" }) # Set content using theme elements (automatic positioning & styling) result = await call_tool("set_slide_content", { "title": "Project Overview", "subtitle": "Q4 2024 Results", "bullet_points": ["Revenue up 15%", "New markets entered", "Team expansion"] }) # Check what theme elements are available result = await call_tool("get_slide_default_elements", {"slide_number": 1})

Manual Content Placement

# Add text to specific position result = await call_tool("add_text_box", { "text": "Custom positioned text", "x": 100, "y": 200 }) # Add image with precise placement result = await call_tool("add_image", { "image_path": "/path/to/image.jpg", "x": 300, "y": 150 })

🚀 What's New in This Fork

This enhanced version includes significant improvements over the original:

Major Enhancements

  • 🏗️ Modular Architecture: Split monolithic AppleScript into 5 specialized modules for better maintainability
  • 🎨 Theme-Aware Content: Smart content placement using Keynote's built-in design elements
  • 📚 Comprehensive Documentation: Complete guides in the docs/ folder
  • 🔧 Enhanced Integration: Improved Python-AppleScript modular execution
  • 🌍 Internationalization: All Chinese comments translated to English

🎯 Key Benefits

  • Professional Results: Theme-aware functions create presentations with consistent styling
  • Better Performance: Modular loading only loads necessary AppleScript code
  • Easier Maintenance: Specialized files for different functionality areas
  • Developer Friendly: Complete documentation and architecture guides

Credits: This fork is based on the original keynote-mcp by @easychen. We've enhanced it with modern architecture and professional content management features.

License

MIT License

-
security - not tested
A
license - permissive license
-
quality - not tested

A 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.

  1. Features
    1. Quick Setup
      1. Available Tools (26 total)
        1. Presentation Management
        2. Slide Operations
        3. Content Management
        4. Export & Capture
        5. Theme-Aware Features
      2. 📚 Documentation
        1. Quick Links
      3. 💡 Usage Examples
        1. Theme-Aware Content (Recommended)
        2. Manual Content Placement
      4. 🚀 What's New in This Fork
        1. ✨ Major Enhancements
        2. 🎯 Key Benefits
      5. License

        Related MCP Servers

        • -
          security
          F
          license
          -
          quality
          A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
          Last updated -
          2
          Python
          • Apple
          • Linux
        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that enables AI models to create and manipulate PowerPoint presentations with advanced features like financial charts, formatting, and template management.
          Last updated -
          1
          Python
        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that enables AI assistants to interact with Apple Reminders on macOS, allowing users to view lists, retrieve, create, complete, and delete reminders through natural language.
          Last updated -
          TypeScript
          • Apple
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables AI assistants to manage meeting data, including creating meeting bots, searching transcripts, and organizing calendar events.
          Last updated -
          16
          TypeScript
          MIT License
          • Apple

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/betancur/keynote-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server