You can generate polished PPTX presentations from Markdown using this MCP server. It supports inline and block code, tables, bold formatting, bullet lists, mixed slide content, and custom branding to produce professional slides from your lesson plans and documentation.

How to use

You interact with the server through an MCP client. After you install and configure the MCP server, you can ask your MCP client to generate a presentation by describing the slides you want. The client will route your request to the PPTX Generator MCP server, which will produce a PowerPoint file that matches your Markdown content, including code formatting, tables, and branding elements.

Typical usage patterns include requesting a new presentation from Markdown content, loading a template, querying current settings, or updating the instructor or branding details. The server handles a variety of slide types and content layouts to assemble a cohesive deck that aligns with your course or documentation goals.

How to install

Prerequisites you need before installation:

• Node.js 18.0 or higher
• Claude Desktop
• macOS, Linux, or Windows

Choose an installation method and follow the steps.

Method 1: Quick Install (Recommended)

cd ~/Documents  # or any directory you prefer
git clone https://github.com/dmytro-ustynov/pptx-generator-mcp.git
cd pptx-generator-mcp

./install.sh

The script will:

• Install all dependencies
• Install the command globally
• Show you the Claude Desktop configuration

Configure Claude Desktop by adding a local MCP server entry that points to the installed command.

{ "mcpServers": { "pptx-generator": { "command": "pptx-generator-mcp" } } }

Restart Claude Desktop to make the pptx-generator tools available.

## Method 2: Manual Install

If you prefer not to run the installer, you can install manually.

Clone the repository

git clone https://github.com/dmytro-ustynov/pptx-generator-mcp.git cd pptx-generator-mcp npm install

npm install -g .

Or use sudo if needed:

sudo npm install -g .

which pptx-generator-mcp

Should show: /usr/local/bin/pptx-generator-mcp (or similar)

Configure Claude Desktop with the same MCP server entry used in Method 1.

## Configuration

Configure Claude Desktop to use the installed MCP server.

macOS/Linux

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

notepad %APPDATA%\Claude\claude_desktop_config.json

Add this MCP server configuration to the Claude Desktop config.

{ "mcpServers": { "pptx-generator": { "command": "pptx-generator-mcp" } } }

If you have other MCP servers, include them alongside this entry and restart Claude Desktop for changes to take effect.

## Customization

Customize branding and appearance by editing the configuration used by the MCP server. You can adjust instructor details, institution information, colors, fonts, and font sizes to align with your branding guidelines.

Find your installation and edit the global config to affect generated presentations.

Locate global config

npm list -g pptx-generator-mcp

Edit the config.json in the installation directory

cd $(npm root -g)/pptx-generator-mcp nano config.json

Configuration options include instructor information, institution details, colors, fonts, and font sizes. After editing, changes apply to the next generated presentation.

## Usage

In Claude Desktop you can generate presentations, load templates, view current settings, and update instructor details using simple commands in your chat.

Common actions you can perform include:

Create a presentation about Docker basics with 5 slides

The system uses the following tools to perform actions like generating a presentation, retrieving templates, and updating configuration.

## Markdown Format

Presentations are created from Markdown with a frontmatter header and slide blocks.

Frontmatter (Required) includes discipline, type, module, and lesson.

Slide types include plan slides, divider slides, and content slides with text, code, and tables.

Formatting supports bold, inline code, code blocks, tables, and bullet lists.

Code blocks should be fenced with triple backticks and optional language specifiers.

discipline: Web Development type: practical module: "3: Docker and Containers" lesson: "3.1: Basics of Docker"

[plan] Plan the lesson

• Topic 1
• Topic 2
• Topic 3

## Examples

Examples illustrate simple and advanced usage with Markdown content that includes plans, dividers, content blocks, code, and tables.

## Troubleshooting

If you encounter issues, verify that the MCP server is installed globally, ensure Claude Desktop can access the command, and check the MCP server configuration.

Command not found: pptx-generator-mcp

npm list -g pptx-generator-mcp

## Updating

To update to the latest version, pull changes, reinstall dependencies, and reconfigure Claude Desktop if needed.

cd /path/to/pptx-generator-mcp git pull npm install npm install -g .

## Uninstalling

To remove the MCP server, uninstall the global command and delete the installation directory. Also remove the server entry from Claude Desktop configuration.

npm uninstall -g pptx-generator-mcp rm -rf /path/to/pptx-generator-mcp

## Available tools

### pptx-generator:generate\_presentation

Generates a PPTX presentation from Markdown content, producing slides with plan, divider, and content sections.

### pptx-generator:get\_template

Retrieves a Markdown template for creating presentations.

### pptx-generator:get\_config

Returns the current MCP server configuration used by the PPTX generator.

### pptx-generator:update\_instructor

Updates the instructor branding details used in generated slides.