Skip to content
Back to search

keynote-mcp

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/easychen--keynote-mcp/badge.svg)](/listings/easychen--keynote-mcp)

HTML

<a href="/listings/easychen--keynote-mcp"><img src="/api/listings/easychen--keynote-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

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

Installation

1. **Clone the repository**

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

2. **Install dependencies**

   pip install -r requirements.txt

3. **Configure environment (optional for Unsplash features)**

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

4. **Set up macOS permissions** - Go to **System Preferences** > **Security & Privacy** > **Privacy** - Add Terminal and Python to **Accessibility** permissions - Add Python to **Automation** permissions for Keynote

Usage with MCP Clients

Gemini CLI Configuration

Add this configuration to your MCP client:

{
  "KeynoteServer": {
    "command": "python",
    "args": ["start_server.py"],
    "env": {
      "UNSPLASH_KEY": "your_unsplash_api_key_here"
    },
    "cwd": "/path/to/keynote-mcp",
    "timeout": 5000
  }
}

Claude Desktop Configuration

Add to your `claude_desktop_config.json`:

{
  "mcpServers": {
    "keynote": {
      "command": "python",
      "args": ["/path/to/keynote-mcp/start_server.py"],
      "env": {
        "UNSPLASH_KEY": "your_unsplash_api_key_here"
      }
    }
  }
}

Other MCP Clients

For other MCP-compatible clients, use these connection details: - **Command**: `python` - **Args**: `["start_server.py"]` - **Working Directory**: `/path/to/keynote-mcp` - **Environment**: `{"UNSPLASH_KEY": "your_api_key"}` (optional)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 187 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Keynote-MCP
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  3. [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
  4. [![macOS](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
  5. https://github.com/user-attachments/assets/fb293e54-0795-434f-a811-7f850d36619f
  6. > ⚠️ **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.
  7. A Model Context Protocol (MCP) server that enables AI assistants to control Keynote presentations through AppleScript automation.
  8. **[中文文档](README_zh.md)** | **[English](README.md)**
  9. ## ✨ Features
  10. - 🎨 **Complete Presentation Management** - Create, open, save, and close presentations
  11. - 📊 **Rich Slide Operations** - Add, delete, duplicate, and move slides
  12. - 📝 **Powerful Content Management** - Add text, images, shapes, tables, and charts
  13. - 📸 **Flexible Export Options** - Screenshot slides, export to PDF and images
  14. - 🖼️ **Unsplash Integration** - Automatically search and add high-quality images
  15. - 🔒 **Secure & Reliable** - Comprehensive error handling and permission management
  16. - 🧪 **Well Tested** - Unit and integration test coverage
  17. ---
  18. ## 🚀 Quick Start
  19. ### Prerequisites
  20. - macOS 10.14 or later
  21. - Keynote application
  22. - Python 3.8 or later
  23. ### Installation
  24. 1. **Clone the repository**
  25. ```bash
  26. git clone https://github.com/easychen/keynote-mcp.git
  27. cd keynote-mcp
  28. ```
  29. 2. **Install dependencies**
  30. ```bash
  31. pip install -r requirements.txt
  32. ```
  33. 3. **Configure environment (optional for Unsplash features)**
  34. ```bash
  35. cp env.example .env
  36. # Edit .env file and add your Unsplash API key
  37. ```
  38. 4. **Set up macOS permissions**
  39. - Go to **System Preferences** > **Security & Privacy** > **Privacy**
  40. - Add Terminal and Python to **Accessibility** permissions
  41. - Add Python to **Automation** permissions for Keynote
  42. ### Usage with MCP Clients
  43. #### Gemini CLI Configuration
  44. Add this configuration to your MCP client:
  45. ```json
  46. {
  47. "KeynoteServer": {
  48. "command": "python",
  49. "args": ["start_server.py"],
  50. "env": {
  51. "UNSPLASH_KEY": "your_unsplash_api_key_here"
  52. },
  53. "cwd": "/path/to/keynote-mcp",
  54. "timeout": 5000
  55. }
  56. }
  57. ```
  58. #### Claude Desktop Configuration
  59. Add to your `claude_desktop_config.json`:
  60. ```json
  61. {
  62. "mcpServers": {
  63. "keynote": {
  64. "command": "python",
  65. "args": ["/path/to/keynote-mcp/start_server.py"],
  66. "env": {
  67. "UNSPLASH_KEY": "your_unsplash_api_key_here"
  68. }
  69. }
  70. }
  71. }
  72. ```
  73. #### Other MCP Clients
  74. For other MCP-compatible clients, use these connection details:
  75. - **Command**: `python`
  76. - **Args**: `["start_server.py"]`
  77. - **Working Directory**: `/path/to/keynote-mcp`
  78. - **Environment**: `{"UNSPLASH_KEY": "your_api_key"}` (optional)
  79. ## 📖 Available Tools
  80. The server provides comprehensive tools for Keynote automation:
  81. ### 🎨 Presentation Management
  82. - Create, open, save, and close presentations
  83. - Set themes and get presentation information
  84. - List all open presentations
  85. ### 📊 Slide Operations
  86. - Add, delete, duplicate, and move slides
  87. - Set slide layouts and get slide information
  88. - Navigate between slides
  89. ### 📝 Content Management
  90. - Add text boxes, titles, and subtitles
  91. - Insert images from files or Unsplash
  92. - Create bullet lists and numbered lists
  93. - Add code blocks and quotes
  94. ### 📸 Export & Screenshot
  95. - Take screenshots of individual slides
  96. - Export presentations to PDF
  97. - Export as image sequences
  98. ### 🖼️ Unsplash Integration (Optional)
  99. - Search high-quality images
  100. - Automatically add images to slides
  101. - Support for different orientations and styles
  102. ## 💡 Usage Examples
  103. Once connected to your MCP client, you can use natural language to control Keynote:
  104. - *"Create a new presentation about AI trends"*
  105. - *"Add a slide with the title 'Machine Learning Basics'"*
  106. - *"Insert an image about technology on slide 2"*
  107. - *"Export the presentation as PDF"*
  108. ## 🔧 Unsplash Configuration (Optional)
  109. To use Unsplash image features:
  110. 1. **Get API Key**: Visit [Unsplash Developers](https://unsplash.com/developers)
  111. 2. **Configure**: Add your API key to the `.env` file:
  112. ```bash
  113. UNSPLASH_KEY=your_unsplash_access_key_here
  114. ```
  115. ## 📚 Documentation
  116. - [Installation Guide](docs/installation.md) - Detailed setup instructions
  117. - [Technical Documentation](TECH.md) - API reference and architecture
  118. - [Examples](examples/) - Usage examples and demos
  119. ## 🤝 Contributing
  120. We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started.
  121. ## 📄 License
  122. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  123. ## 🏆 Acknowledgments
  124. - [Model Context Protocol](https://modelcontextprotocol.io/) - Standardized tool calling protocol for AI models
  125. - [Unsplash](https://unsplash.com/) - High-quality free images
  126. - [AppleScript](https://developer.apple.com/documentation/applescript) - Powerful macOS automation
  127. ## 📞 Contact
  128. - 🐛 Issues: [GitHub Issues](https://github.com/easychen/keynote-mcp/issues)
  129. - 💬 Discussions: [GitHub Discussions](https://github.com/easychen/keynote-mcp/discussions)
  130. ## ⭐ Support
  131. If this project helps you, please give it a ⭐️!
  132. ---
  133. *Empowering AI assistants to create and manage Keynote presentations effortlessly.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.