Marp MCP Server

[!TIP] This package includes a Claude Code Skill. After installing, Claude Code can create Marp presentations via the /marp command using the built-in CLI — no MCP server configuration required!

Auto-updating plugin install:

/plugin marketplace add masaki39/marp-mcp
/plugin install marp@marp-mcp

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, supporting the built-in Marp themes (default, Gaia, Uncover) and a rich set of academic and professional presentation styles.

⚙️ Setup

Claude Code

Option 1 — CLI, user scope (recommended):

claude mcp add marp-mcp -- npx -y @masaki39/marp-mcp@latest

Option 2 — CLI, project scope (shareable with team via .mcp.json):

claude mcp add --scope project marp-mcp -- npx -y @masaki39/marp-mcp@latest

Option 3 — Manual config (~/.claude/settings.json or .mcp.json):

{
  "mcpServers": {
    "marp-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/marp-mcp@latest"]
    }
  }
}

Other MCP clients

{
  "mcpServers": {
    "marp-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/marp-mcp@latest"]
    }
  }
}

Setting server default theme/style

Use -t / --theme and -s / --style args to set the server-wide default. Choose from themes: default, gaia, uncover. Styles: default, rich, minimal, dark, corporate, academic, tech:

{
  "mcpServers": {
    "marp-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/marp-mcp@latest", "-t", "default", "-s", "rich"]
    }
  }
}

Omitting these flags defaults to default theme and default style.

External styles via marp-cli config

If a marp-cli configuration file (.marprc.{yml,yaml,json,js,cjs,mjs}, marp.config.{js,cjs,mjs}, or a marp field in package.json) is found anywhere up the directory tree at server start, every CSS file listed under its themeSet field is registered as an MCP style. The style name is read from the file's /* @theme NAME */ directive (lowercased). External entries reuse the active theme's layouts, so all existing tools work unchanged.

# .marprc.yml
themeSet:
  - ./themes/sample.css

/* themes/sample.css */
/* @theme sample */
section { background: #fff; }

sample is then a valid value for -s and shows up in list_themes_and_styles with "external": true and the absolute CSS path under source. Built-in style names are protected; any external collision is logged and skipped.

🛠️ Tools

Tool	Description
list_themes_and_styles	List all available themes and styles; shows current server defaults
list_layouts	List available slide layouts for a theme/style combination
create_presentation	Create a new presentation with frontmatter and title slide in one step
manage_slide	Insert, replace, delete, or move slides using slide IDs (ID-based operations)
batch_manage_slides	Apply multiple slide operations in one call (single file read/write)
set_frontmatter	Ensure marp, theme, header, and paginate frontmatter fields are present
read_slide	Read slide content by ID or list all slides with their IDs and positions
generate_slide_ids	Generate stable UUIDs for every slide (safe to re-run)
export_slide	Export to HTML, PDF, or PPTX using marp-cli
generate_agenda	Auto-generate an agenda slide; adds numbered icons to section slides for view-transition morphing (HTML only)
add_image_transition	Insert a full-screen background image slide before a target slide and tag images for view-transition morphing (HTML only)

Per-call theme/style override

list_layouts, manage_slide, and set_frontmatter accept optional theme and style parameters to override the server default for a single call. This lets one server instance handle all theme/style combinations without restarting:

{ "theme": "gaia", "style": "rich" }

Omit either parameter to fall back to the server default.

🎨 Example

Rendered samples (GitHub Pages):

• Default theme
• Gaia theme
• Uncover theme
• Default theme, rich style
• Default theme, minimal style
• Default theme, dark style
• Default theme, corporate style
• Default theme, academic style
• Default theme, tech style

📐 Available Layouts

Default theme

Layout	Description
title	Title slide with heading and content
section	Section break slide with centered title and subtitle
list	List slide with bullet points (max 8 items)
table	Table slide with description (max 7 rows)
image-right	Slide with image on right and content list (allows more explanation than image-center)
image-center	Slide with centered image (fixed h:350)
content	Standard content slide with heading and free-form markdown body (supports bullets with -, bold with **, code with backticks)

Styles

rich — Rich visual style with cards, timelines, grids, gradients, and more

Layout	Description
title	Hero title slide with dark gradient background
section	Section divider slide with gradient background
list	List slide with bullet points
table	Rich table slide with styled header and zebra stripes
image-right	Rich image-right slide with content on left and image on right (60:40 split)
image-center	Rich centered image slide with rounded corners and shadow
image-split	Image on the left with content list on the right (40:60 split)
timeline	Vertical timeline with labeled events (use 'Label: Description' format)
card-grid	Grid of cards with icon, title, and description (use 'Icon
statistics	Statistics display with large numbers and labels (use 'Number
highlight-box	Centered gradient message box for key takeaways or announcements
two-column-panel	Two-column layout with styled panels, optional accent highlight on one panel
three-column-panel	Three-column layout with styled panels (use 'Title
image-comparison	Two images side by side with labels for comparison
content	Free-form markdown content slide
quote	Quote slide with attribution
process	Horizontal process flow with numbered steps and arrows
two-column	Simple two-column layout with headings and lists
big-statement	Large impactful statement slide with bold centered text
sidebar	Main content with sidebar for supplementary info, definitions, or references
progress-bar	Horizontal progress bars for metrics visualization (use 'Label

minimal — Clean, flat design with typography focus and minimal decoration

Layout	Description
title	Clean black title slide with white text
section	Simple black section divider slide
content	Pure markdown content slide
list	Simple bullet list slide
table	Minimal table with black header and clean borders
image-right	Text on left, image on right (60:40 split), clean design
image-center	Centered image slide, clean and minimal
quote	Quote slide with left border accent, no extra decoration
two-column	Two-column layout with a thin divider line
big-statement	Large impactful statement slide with bold centered text
statistics	Minimal statistics display with black numbers and thin underline (use 'Number
highlight-box	Minimal message box for key takeaways
pull-quote	Minimal decorative impact quote with large quotation marks
agenda	Clean agenda slide with numbered items and optional time durations (use 'Item name
comparison	Side-by-side comparison with explicit left/right titles and list items, separated by a thin divider

dark — Dark mode style with indigo and emerald accents, developer-friendly

Layout	Description
title	Dark title slide with indigo-violet gradient
section	Dark section divider with slate-to-indigo gradient
content	Free-form markdown content slide on dark background
list	Bullet list slide on dark background
table	Dark table with indigo header
card-grid	Dark card grid with icon, title, and description (use 'Icon
timeline	Dark vertical timeline with indigo-to-emerald gradient line (use 'Label: Description' format)
statistics	Dark statistics display with large indigo numbers (use 'Number
image-right	Text on left, image on right on dark background (60:40 split)
terminal	Terminal-style command display on dark background (prefix lines with '$ ' for commands)
quote	Dark quote slide with attribution
image-center	Dark centered image slide
process	Dark horizontal process flow with numbered steps and arrows
two-column	Dark two-column layout with panels
big-statement	Dark large impactful statement slide with bold centered text
highlight-box	Dark gradient message box for key takeaways or announcements
progress-bar	Dark horizontal progress bars for metrics visualization (use 'Label
chart-bar	Dark CSS horizontal bar chart for data visualization (use 'Label
timeline-horizontal	Dark horizontal timeline with labeled events (use 'Label: Description' format)
code-comparison	Side-by-side code comparison (Before/After or two languages)
code-showcase	Code block with language badge, optional explanation text, and optional highlight bullet points

corporate — Professional business style with navy color scheme, structured layouts

Layout	Description
title	Professional navy gradient title slide
section	Corporate navy-to-sky section divider slide
content	Standard business content slide with markdown
list	Business bullet list slide
table	Business table with navy header and clean rows
two-column	Two-column comparison layout with navy-accented panels
three-column	Three-column layout with sky-accented panels
statistics	Business metrics display with large navy num