keynote-mcp

[](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://www.apple.com/macos/)

https://github.com/user-attachments/assets/fb293e54-0795-434f-a811-7f850d36619f

> ⚠️ Development Notice: This project was developed using Cursor AI without human code review. It's provided for educational and experimental purposes only. Please use with caution in production environments and conduct thorough testing before deployment.

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

[中文文档](README_zh.md) | [English](README.md)

• 🎨 Complete Presentation Management - Create, open, save, and close presentations
• 📊 Rich Slide Operations - Add, delete, duplicate, and move slides
• 📝 Powerful Content Management - Add text, images, shapes, tables, and charts
• 📸 Flexible Export Options - Screenshot slides, export to PDF and images
• 🖼️ Unsplash Integration - Automatically search and add high-quality images
• 🔒 Secure & Reliable - Comprehensive error handling and permission management
• 🧪 Well Tested - Unit and integration test coverage

---

• macOS 10.14 or later
• Keynote application
• Python 3.8 or later

1. Clone the repository

   git clone https://github.com/easychen/keynote-mcp.git
   cd keynote-mcp

1. Install dependencies

   pip install -r requirements.txt

1. Configure environment (optional for Unsplash features)

   cp env.example .env
   # Edit .env file and add your Unsplash API key

1. Set up macOS permissions

• Go to System Preferences > Security & Privacy > *