Skip to main content
Glama

Keynote-MCP

by easychen
MIT License
1
  • Apple

Keynote-MCP

⚠️ 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.

中文文档 | English

✨ Features

  • 🎨 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

🚀 Quick Start

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)

📖 Available Tools

The server provides comprehensive tools for Keynote automation:

🎨 Presentation Management

  • Create, open, save, and close presentations
  • Set themes and get presentation information
  • List all open presentations

📊 Slide Operations

  • Add, delete, duplicate, and move slides
  • Set slide layouts and get slide information
  • Navigate between slides

📝 Content Management

  • Add text boxes, titles, and subtitles
  • Insert images from files or Unsplash
  • Create bullet lists and numbered lists
  • Add code blocks and quotes

📸 Export & Screenshot

  • Take screenshots of individual slides
  • Export presentations to PDF
  • Export as image sequences

🖼️ Unsplash Integration (Optional)

  • Search high-quality images
  • Automatically add images to slides
  • Support for different orientations and styles

💡 Usage Examples

Once connected to your MCP client, you can use natural language to control Keynote:

  • "Create a new presentation about AI trends"
  • "Add a slide with the title 'Machine Learning Basics'"
  • "Insert an image about technology on slide 2"
  • "Export the presentation as PDF"

🔧 Unsplash Configuration (Optional)

To use Unsplash image features:

  1. Get API Key: Visit Unsplash Developers
  2. Configure: Add your API key to the .env file:
    UNSPLASH_KEY=your_unsplash_access_key_here

📚 Documentation

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on how to get started.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🏆 Acknowledgments

📞 Contact

⭐ Support

If this project helps you, please give it a ⭐️!


Empowering AI assistants to create and manage Keynote presentations effortlessly.

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

A Model Context Protocol server that enables AI assistants to control Apple Keynote presentations through AppleScript automation, supporting comprehensive slide creation, management, and content operations.

  1. ✨ Features
    1. 🚀 Quick Start
      1. Prerequisites
      2. Installation
      3. Usage with MCP Clients
    2. 📖 Available Tools
      1. 🎨 Presentation Management
      2. 📊 Slide Operations
      3. 📝 Content Management
      4. 📸 Export & Screenshot
      5. 🖼️ Unsplash Integration (Optional)
    3. 💡 Usage Examples
      1. 🔧 Unsplash Configuration (Optional)
        1. 📚 Documentation
          1. 🤝 Contributing
            1. 📄 License
              1. 🏆 Acknowledgments
                1. 📞 Contact
                  1. ⭐ Support

                    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/easychen/keynote-mcp'

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