mcp-powerpoint

MCP PowerPoint Plugin

A Model Context Protocol (MCP) plugin for PowerPoint operations, allowing AI assistants to create and manipulate PowerPoint presentations programmatically.

Features

• Create new PowerPoint presentations
• Add slides to presentations
• Get slides information from a presentation
• Export presentations to PDF
• Read presentation metadata and structure

Installation

# Clone the repository
git clone https://github.com/islem-zaraa/mcp-powerpoint.git

# Navigate to the project directory
cd mcp-powerpoint

# Install dependencies
npm install

# Link for local development
npm link

Usage as CLI

This plugin can be used directly as a command-line tool:

# Create a new presentation
mcp-powerpoint create --outputPath="presentation.pptx" --title="My Presentation"

# Add a slide to an existing presentation
mcp-powerpoint add-slide --file="presentation.pptx" --title="New Slide" --content="This is the content of the slide"

# Get slides from a presentation
mcp-powerpoint get-slides --file="presentation.pptx"

# Export presentation to PDF
mcp-powerpoint export-pdf --file="presentation.pptx" --outputPath="presentation.pdf"

# Read presentation metadata
mcp-powerpoint read --file="presentation.pptx"

Usage as MCP Plugin

This plugin can be integrated into an MCP-compatible AI assistant system:

const mcpPowerPointPlugin = require('mcp-powerpoint/src/mcp-plugin');

// Register the plugin with your MCP system
mcpSystem.registerPlugin(mcpPowerPointPlugin);

// Now the AI can use the PowerPoint functions through the MCP protocol
// Example function calls:
// - mcp_powerpoint_create_presentation
// - mcp_powerpoint_add_slide
// - mcp_powerpoint_get_slides
// - mcp_powerpoint_export_to_pdf
// - mcp_powerpoint_read_presentation

Function Descriptions

mcp_powerpoint_create_presentation

Creates a new PowerPoint presentation.

Parameters:

• outputPath: Path where to save the PowerPoint file (must end with .pptx)
• title: (Optional) Title of the presentation

mcp_powerpoint_add_slide

Adds a slide to an existing PowerPoint presentation.

Parameters:

• file: Path to the PowerPoint file
• title: (Optional) Title of the slide
• content: (Optional) Content of the slide

mcp_powerpoint_get_slides

Gets slides from a PowerPoint presentation.

Parameters:

• file: Path to the PowerPoint file

mcp_powerpoint_export_to_pdf

Exports a PowerPoint presentation to PDF.

Parameters:

• file: Path to the PowerPoint file
• outputPath: Path where to save the PDF file (must end with .pdf)

mcp_powerpoint_read_presentation

Reads metadata and structure from a PowerPoint presentation.

Parameters:

• file: Path to the PowerPoint file

Limitations

• The plugin currently provides basic PowerPoint functionality
• Editing existing slides has limitations due to the complexity of the PPTX format
• The PDF export is a simulated feature in this version

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. ### Topics

• mcp
• model-context-protocol
• mcp-server
• powerpoint
• presentation
• slides
• office