-
securityF
license-
qualityA 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 -
18
Enables AI assistants to control Keynote presentations through AppleScript automation, with capabilities for presentation management, slide operations, and theme-aware content placement.
Leverages macOS automation features to control Keynote presentations, requiring specific macOS permissions for accessibility and automation.
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
Clone the repository
git clone https://github.com/betancur/keynote-mcp.git cd keynote-mcpInstall dependencies
pip install -r requirements.txtGrant macOS permissions
System Preferences > Security & Privacy > Privacy
Add Terminal and Python to Accessibility permissions
Add Python to Automation permissions for Keynote
Configure Claude Desktop Edit
~/Library/Application Support/Claude/claude_desktop_config.json:{ "mcpServers": { "keynote": { "command": "python3", "args": ["/path/to/keynote-mcp/mcp_server.py"] } } }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 presentationopen_presentation- Open existing presentationsave_presentation- Save presentationclose_presentation- Close presentation
Slide Operations
add_slide- Add new slidedelete_slide- Delete slideduplicate_slide- Copy slidemove_slide- Reorder slides
Content Management
add_text_box- Add text to slideadd_image- Add image to slideset_slide_content- 🆕 Set content using theme elements (recommended)get_slide_default_elements- 🆕 Check available theme elements
Export & Capture
screenshot_slide- Take slide screenshotexport_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)
# 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
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
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.
Related MCP Servers
- -securityFlicense-qualityA 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 -24
- AsecurityFlicenseAqualityA 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 -56
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants to manage meeting data, including creating meeting bots, searching transcripts, and organizing calendar events.Last updated -20MIT License