mcp-pandoc-md2pptx: Markdown to PowerPoint Converter
A Model Context Protocol server for converting Markdown content to PowerPoint (PPTX) presentations using pandoc.
Overview
This MCP server provides a simple tool to transform Markdown content into PowerPoint presentations while preserving formatting and structure. Perfect for creating presentations from documentation, notes, or any Markdown content.
Tools
convert-contents- Converts Markdown content to PowerPoint (PPTX) format
- Inputs:
contents(string): Markdown content to convert (required if input_file not provided)input_file(string): Path to Markdown input file (required if contents not provided)output_file(string): Complete path for PPTX output file (required)template(string): Path to a template PPTX document to use for styling (optional)
Usage & Configuration
{
"mcpServers": {
"mcp-pandoc-md2pptx": {
"command": "uvx",
"args": ["mcp-pandoc-md2pptx"]
}
}
}
Prerequisites
-
Pandoc Installation
# macOS brew install pandoc # Ubuntu/Debian sudo apt-get install pandoc # Windows # Download from: https://pandoc.org/installing.html -
UV Package Installation
# macOS brew install uv # Windows/Linux pip install uv
Examples
Basic Conversion
"Convert this markdown to PowerPoint and save as /presentations/demo.pptx:
# My Presentation
## Slide 1
Content here"
File Conversion
"Convert /path/to/input.md to PPTX and save as /path/to/output.pptx"
With Custom Template
"Convert markdown to PPTX using /templates/theme.pptx as template and save as /presentations/styled.pptx"
Template Support
Create custom PowerPoint templates for consistent branding:
-
Generate default template:
pandoc -o template.pptx --print-default-data-file reference.pptx -
Customize in PowerPoint with your fonts, colors, and slide layouts
-
Use in conversion:
"Convert content using /path/to/template.pptx as template"
Installation
Option 1: Manual Configuration
Add to your Claude Desktop config:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-pandoc-md2pptx": {
"command": "uvx",
"args": ["mcp-pandoc-md2pptx"]
}
}
}
Option 2: Smithery (Automatic)
npx -y @smithery/cli install mcp-pandoc-md2pptx --client claude
Development
Testing
uv run pytest
Building
uv sync
uv build
Publishing
uv publish
Contributing
- Report Issues: GitHub Issues
- Submit Pull Requests: Improve the codebase or add features
Acknowledgement
Special thanks to MCP Pandoc and pandoc-ext/diagram
Simple, focused Markdown to PowerPoint conversion via MCP