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:
{
"mcpServers": {
"marp-mcp": {
"command": "npx",
"args": ["-y", "@masaki39/marp-mcp@latest"]
}
}
}Theme selection
Use -t or --theme args for theme selection. Choose from default, gaia, uncover, or academic:
{
"command": "npx",
"args": [
"-y",
"@masaki39/marp-mcp@latest",
"-t",
"default"]
}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:
{
"command": "npx",
"args": [
"-y",
"@masaki39/marp-mcp@latest",
"-s",
"rich"]
}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:
npm run examples:generateGenerate HTML files locally:
npm run examples:htmlPreview examples with live reload (recommended for testing):
npm run examples:server
# Open http://localhost:8080 in your browserNote: HTML files are automatically generated and deployed to GitHub Pages by CI/CD. They are not committed to git.
License
MIT License