Create and manage Marp presentations using AI through natural language commands.
Initialize presentation projects - Set up complete project structure with directories, custom themes, and template files using project path, name, and title
Generate slide content - Create individual slides with 7 academic layout types: title, section, content, table, multi-column, figure (background images), and image (centered images)
List available layouts - View all slide layouts with their descriptions and accepted parameters
Customize themes - Modify colors, fonts, and layouts through CSS customization
Preview and export - View presentations in VS Code and export to PDF, HTML, or PowerPoint formats
Compatible with MCP-enabled applications - Works with Claude Code, Cursor, Cline and other tools
Includes pre-configured academic_custom.css theme with custom fonts, color schemes, table styles, and multi-column layouts for presentations
Automatically generates .gitignore files as part of presentation project initialization
References GitHub repository for the MCP server source code and contribution
Built using JavaScript/Node.js and distributed as an npm package
Generates presentation slides as Markdown files with Marp-specific syntax and formatting
Distributed as an npm package with installation options via npx, global, or local installation
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Marp MCP Servercreate a presentation about AI trends with a title slide and three list slides"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Marp MCP Server
An MCP server for creating and editing Marp presentations with AI assistance. This MCP server allows LLMs to edit Markdown files according to a specified layout, and now supports the default Marp theme along with Gaia, Uncover, and the Academic in this repository.
Setup
Add to your MCP client configuration:
Theme selection
Use -t or --theme args for theme selection. Choose from default, gaia, uncover, or academic:
Tools
Tool | Description |
| List all available slide layouts with parameters and descriptions |
| Generate slide IDs for every slide |
| Insert, replace, or delete slides using slide IDs (ID-based operations) |
| Ensure |
Style selection
Use -s or --style args for style selection. Choose from default or rich. Styles are designed for the default theme:
Available Layouts
Layout | Description |
| Title slide with left-aligned heading and metadata |
| Section divider with centered title and subtitle |
| Content slide with heading and bullet points or text |
| Table layout with customizable size and alignment |
| Two-column layout for side-by-side content (academic theme only) |
| Layout with image on the right side |
| Centered image layout with adjustable dimensions |
Rich style additional layouts
Layout | Description |
| Image with bullet points in a split view |
| Vertical timeline with gradient line and dots |
| Grid of icon cards with title and description |
| Large number statistics with labels |
| Gradient-styled highlight callout box |
| Two styled panels side by side |
| Three styled panels in a row |
| Side-by-side image comparison with labels |
| Free-form markdown content slide |
| Styled blockquote with attribution |
| Horizontal process flow with numbered steps and arrows |
Example
Rendered samples (GitHub Pages):
Development
Working with Examples
Generate markdown examples:
Generate HTML files locally:
Preview examples with live reload (recommended for testing):
Note: HTML files are automatically generated and deployed to GitHub Pages by CI/CD. They are not committed to git.
License
MIT License