PowerPoint MCP server

The MCP PowerPoint Plugin allows AI assistants to create and manipulate PowerPoint presentations programmatically. It provides essential functionality to create presentations, add slides, read slide information, and export to PDF through a simple command-line interface or as an integrated MCP plugin.

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

Command-Line Usage

You can use the plugin directly from the command line:

Creating a Presentation

mcp-powerpoint create --outputPath="presentation.pptx" --title="My Presentation"

Adding a Slide

mcp-powerpoint add-slide --file="presentation.pptx" --title="New Slide" --content="This is the content of the slide"

Getting Slide Information

mcp-powerpoint get-slides --file="presentation.pptx"

Exporting to PDF

mcp-powerpoint export-pdf --file="presentation.pptx" --outputPath="presentation.pdf"

Reading Presentation Metadata

mcp-powerpoint read --file="presentation.pptx"

Using as an MCP Plugin

For integration with an AI assistant system:

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

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

Available Functions

Creating a Presentation

The mcp_powerpoint_create_presentation function creates a new PowerPoint file.

Parameters:

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

Adding Slides

Use mcp_powerpoint_add_slide to add a new slide to an existing presentation.

Parameters:

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

Retrieving Slides

The mcp_powerpoint_get_slides function extracts slide information.

Parameters:

• file: Path to the PowerPoint file

PDF Export

Convert presentations to PDF with mcp_powerpoint_export_to_pdf.

Parameters:

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

Reading Presentation Data

The mcp_powerpoint_read_presentation function retrieves metadata and structure.

Parameters:

• file: Path to the PowerPoint file

Current Limitations

• Basic PowerPoint functionality only
• Limited ability to edit existing slides
• PDF export is simulated in the current version

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.