Keynote-MCP

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:

• 📖 Documentation Index - Complete documentation overview
• 🏗️ Modular Architecture - AppleScript modular structure
• 🎨 Theme-Aware Content - Best practices for theme elements
• 🗺️ Project Roadmap - Future development plans and features

Quick Links

• Getting Started: Follow the Quick Setup section above
• For Developers: Modular Architecture
• Best Practices: Theme-Aware Content

💡 Usage Examples

Theme-Aware Content (Recommended)

Manual Content Placement

🚀 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