MCP Server

Beta

The Slides MCP server lets AI assistants find, create, edit, and share your presentations. You don't need anything technical to get started: Claude, ChatGPT, and other popular tools connect in a minute.

Connecting AI tools requires an active Slides subscription. Review and disconnect tools at any time in Connected apps.

Connect manually

For any other tool that supports remote MCP servers, add Slides yourself:

  1. Copy the Slides server URL.

    https://mcp.slides.com/
  2. Add it as a remote MCP server in your AI tool. Some tools call this a custom connector or app.

  3. Sign in to Slides when prompted, choose Full access or Read-only, and click Allow access.

Connect with an API key

For tools that can't sign in with OAuth, create an API key and send it as an Authorization: Bearer header. Choose Full access if the tool should make changes. Tools that only launch local MCP processes can use a bridge such as mcp-remote:

API key configuration

{
  "mcpServers": {
    "slides": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.slides.com/",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Tools

The server exposes the core deck operations as named tools, plus an authoring guide, batch slide retrieval, slide screenshots, and an interactive deck library and presentation viewer for clients that support MCP Apps. Call get_authoring_guide before creating or editing slide HTML.

Tool

get_authoring_guide

Call before creating or editing slide HTML to get supported content blocks, slide attributes, canvas sizing, themes, and examples.

Inputs

No request parameters.

Returns

The complete authoring guide as Markdown text in the tool response.

Tool

list_templates

Lists the built-in deck templates. Each is a designed deck whose slides are layouts with named slots, so a deck can be built by choosing layouts and sending text instead of writing slide HTML.

Inputs

No request parameters.

Returns

Each template has id, name, summary, tags, thumbnail_url and the names of its layouts.

Tool

get_template

Returns one template's layouts and slots. Pass the template ID to create_deck, then give each slide a layout and fills.

Inputs

id
Integer Required

Template ID from list_templates.

Example Arguments

{
  "id": 12
}

Returns

The template with a layouts array. Each layout has its name, an optional hint on when to use it, and its slots; a text slot has sample text and its length, plus any rules (required, max, hint). A repeat slot has count and the slots of one item.

Tool

browse_decks

Open an interactive library to browse and preview your owned decks. Available with Read-only or Full access.

Inputs

page
Integer Default 1 Optional

Page number to return. Minimum: 1.

per_page
Integer Default 20 Optional

Number of records to return per page, up to a maximum of 100. Range: 1–100.

q
String Optional

Text matched against deck titles, descriptions, and slide HTML; defaults to an empty search.

sort
String Optional

Ordering: updated_desc (default), created_desc, or title_asc. Allowed values: created_desc, updated_desc, title_asc.

MCP Apps

Linked to ui://slides/deck-library.html. Use browse_decks for the interactive library, view_deck for a specific deck, or list_decks for deck summaries without an app.

Example Arguments

{
  "q": "roadmap",
  "sort": "updated_desc"
}

Returns

Structured content containing decks (id, title, thumbnail_url, updated_at, url), pagination, and effective search/sort filters.

Tool

view_deck

Returns deck metadata and a short-lived MCP App embed URL for an owned deck, optionally opened at a specific slide.

Inputs

id
Integer Required

ID of the deck.

slide_id
String Optional

Optional ID of the slide to open, returned by list_slides. Use the ID, not the slide number.

MCP Apps

Linked to ui://slides/deck-viewer.html. Supported hosts show an interactive preview that stays in sync with deck changes while live updates are connected. Reuse the open preview after edits.

Example Arguments

{
  "id": 456,
  "slide_id": "a1b2c3d4e5f6"
}

Example Structured Content

{
  "id": 456,
  "title": "Quarterly Review",
  "description": "Q1 business update",
  "thumbnail_url": "https://...",
  "url": "https://slides.com/alice/q1-review",
  "urls": {
    "default": "https://slides.com/alice/q1-review",
    "fullscreen": "https://slides.com/alice/q1-review/fullscreen",
    "edit": "https://slides.com/alice/q1-review/edit",
    "present": "https://slides.com/alice/q1-review/live"
  },
  "slug": "q1-review",
  "visibility": "self",
  "slide_count": 12,
  "width": 1280,
  "height": 720,
  "ephemeral_embed_url": "https://mcp.slides.com/decks/456/embed?embed_token=...",
  "ephemeral_embed_url_expires_at": "2030-08-01T09:40:00Z"
}

Returns

Structured content containing deck summary fields, an ephemeral embed URL, and its expiration.

Tool

list_decks

Returns owned deck summaries ordered by newest first.

Inputs

page
Integer Default 1 Optional

Page number to return. Minimum: 1.

per_page
Integer Default 20 Optional

Number of records to return per page, up to a maximum of 100. Range: 1–100.

Returns

Deck summaries are returned in data; meta contains page, per_page, and total.

Tool

list_trashed_decks

Returns owned decks in trash, ordered by the time they were trashed.

Inputs

page
Integer Default 1 Optional

Page number to return. Minimum: 1.

per_page
Integer Default 20 Optional

Number of records to return per page, up to a maximum of 100. Range: 1–100.

Returns

Deck summaries are returned in data with trashed_at and without url; meta contains page, per_page, and total.

Tool

get_deck

Returns details for an owned deck.

Inputs

id
Integer Required

ID of the deck.

include_deck_html
Boolean Default false Optional

Whether to include deck_html, which contains the HTML for all slides in the deck.

Example JSON Content (include_deck_html=true)

{
  "id": 456,
  "title": "Quarterly Review",
  "description": "Q1 business update",
  "thumbnail_url": "https://...",
  "url": "https://slides.com/alice/q1-review",
  "urls": {
    "default": "https://slides.com/alice/q1-review",
    "fullscreen": "https://slides.com/alice/q1-review/fullscreen",
    "edit": "https://slides.com/alice/q1-review/edit",
    "present": "https://slides.com/alice/q1-review/live"
  },
  "slug": "q1-review",
  "visibility": "self",
  "slide_count": 12,
  "css": ".slides h1 { color: #ff0000; }",
  "width": 1280,
  "height": 720,
  "margin": 0.05,
  "transition": "slide",
  "background_transition": "slide",
  "rtl": false,
  "loop": false,
  "theme_font": "montserrat",
  "theme_color": "white-blue",
  "language": "en",
  "created_at": "2026-03-01T12:00:00Z",
  "updated_at": "2026-03-05T09:00:00Z",
  "deck_html": "<section>...</section>"
}

Returns

Returns deck details. Read speaker notes through the slide APIs. deck_html is present only when include_deck_html is true.

Tool

create_deck

Requires Full access

Creates a new deck.

Inputs

title
String Default "deck" Optional

Deck title.

description
String Optional

Deck description.

width
Integer Optional

Canvas width in pixels. Defaults to 1280 on creation. Minimum: 1.

height
Integer Optional

Canvas height in pixels. Defaults to 720 on creation. Minimum: 1.

margin
Number Optional

Viewport margin factor from 0 to 1; defaults to 0 on creation. Reserves space around the presentation during scaling, not padding inside the slide. Range: 0–1.

theme_color
String Optional

Presentation color preset. Defaults to white-blue on creation. View color presets. Allowed values: white-blue, sand-blue, beige-brown, silver-green, silver-blue, sky-blue, blue-yellow, cobalt-orange, asphalt-orange, forest-yellow, mint-beige, sea-yellow, yellow-black, coral-blue, grey-blue, black-blue, black-mint, black-orange.

theme_font
String Optional

Presentation font preset. Defaults to montserrat on creation. View font presets. Allowed values: montserrat, league, opensans, josefine, palatino, news, helvetica, merriweather, asul, sketch, quicksand, overpass2.

visibility
String Optional

Deck visibility. Team accounts may also use team visibility. Allowed values: all, self, team.

transition
String Optional

Transition Allowed values: none, fade, slide, convex, concave, zoom.

slides
Array Optional

Initial slides in presentation order. Each object accepts html (one <section>, no nested sections) and optional notes (speaker notes, up to 10,000 characters). Read get_authoring_guide before writing slide HTML. Content outside .sl-block elements is wrapped in a text block that fills the slide. Preserve existing .sl-block elements and their data-block-id values. Each .sl-block needs a supported data-block-type and exactly one direct child with class .sl-block-content or .sl-block-style. With template_id, an object can instead give a layout and fills, as described for add_slide. Omit html for a blank slide. Omit slides to create one blank slide; an empty array is not accepted.

template_id
Integer Optional

ID of a built-in template from list_templates. The deck takes the template's size, margin, colours, font and transitions, and its slides can then be given as a layout and fills.

Example Arguments

{
  "title": "Quarterly Review",
  "description": "Q1 business update",
  "width": 1280,
  "height": 720,
  "theme_color": "white-blue",
  "theme_font": "montserrat",
  "visibility": "self",
  "slides": [
    {
      "html": "<section><h1>Quarterly Review</h1></section>",
      "notes": "Welcome to the Q1 review."
    },
    {
      "html": "<section><h2>Results</h2><p>Revenue increased by 18%.</p></section>"
    }
  ]
}

Returns

Returns deck metadata and slide_ids in presentation order, without HTML, notes, or CSS. Use the get_slides tool to retrieve content. Validation failures return an error.

Tool

update_deck

Requires Full access

Updates selected fields on an owned deck.

Inputs

id
Integer Required

ID of the deck.

title
String Optional

Deck title.

description
String Optional

Deck description.

width
Integer Optional

Canvas width in pixels. Defaults to 1280 on creation. Minimum: 1.

height
Integer Optional

Canvas height in pixels. Defaults to 720 on creation. Minimum: 1.

margin
Number Optional

Viewport margin factor from 0 to 1; defaults to 0 on creation. Reserves space around the presentation during scaling, not padding inside the slide. Range: 0–1.

theme_color
String Optional

Presentation color preset. Defaults to white-blue on creation. View color presets. Allowed values: white-blue, sand-blue, beige-brown, silver-green, silver-blue, sky-blue, blue-yellow, cobalt-orange, asphalt-orange, forest-yellow, mint-beige, sea-yellow, yellow-black, coral-blue, grey-blue, black-blue, black-mint, black-orange.

theme_font
String Optional

Presentation font preset. Defaults to montserrat on creation. View font presets. Allowed values: montserrat, league, opensans, josefine, palatino, news, helvetica, merriweather, asul, sketch, quicksand, overpass2.

visibility
String Optional

Deck visibility. Team accounts may also use team visibility. Allowed values: all, self, team.

transition
String Optional

Transition Allowed values: none, fade, slide, convex, concave, zoom.

edits
Array Optional

Text replacements across every slide in the deck, applied in order, for changes such as recolouring or renaming. Each edit is a replace_text operation with old_string, new_string and optional replace_all. Without replace_all, old_string must match exactly once in the whole deck. At most 10 edits per call may use replace_all. If any edit fails, nothing is saved.

Example Arguments

{
  "id": 456,
  "title": "Updated title",
  "theme_font": "quicksand",
  "visibility": "all"
}

Returns

Returns deck metadata without HTML, notes, or CSS. Use get_deck with include_deck_html to retrieve HTML. Read-only keys and validation failures return an error.

Tool

trash_deck

Requires Full access

Moves an owned deck to trash without permanently deleting it.

Inputs

id
Integer Required

ID of the deck.

Example JSON Content

{
  "id": 456,
  "trashed": true
}

Returns

JSON content confirming the deck ID and trashed state.

Tool

recover_deck

Requires Full access

Recovers an owned deck from trash.

Inputs

id
Integer Required

ID of the deck.

Example JSON Content

{
  "id": 456,
  "recovered": true
}

Returns

JSON content confirming the deck ID and recovered state.

Tool

list_slides

Returns slide summaries in presentation order without slide HTML or speaker notes. Use the returned IDs to retrieve, edit, move, or remove slides.

Inputs

deck_id
Integer Required

ID of the deck that owns the slides.

page
Integer Default 1 Optional

Page number to return. Minimum: 1.

per_page
Integer Default 50 Optional

Number of records to return per page, up to a maximum of 200. Range: 1–200.

Returns

Slide summaries are returned in data; meta contains page, per_page, and total. Position indexes start at 0. Slides in a vertical group share position.horizontal; position.vertical identifies each slide within the group and is null for ungrouped slides.

Tool

get_slides

Returns selected slides in the requested order and reports IDs that were not found.

Inputs

deck_id
Integer Required

ID of the deck that owns the slides.

slide_ids
Array Required

Slide IDs returned by List slides, in the desired response order. Accepts 1–10 unique IDs.

Example Arguments

{
  "deck_id": 456,
  "slide_ids": [
    "a1b2c3d4e5f6",
    "f6e5d4c3b2a1"
  ]
}

Returns

Returns slides with HTML, speaker notes, and position, plus missing_slide_ids for any IDs not found. Position indexes start at 0. If no IDs are found, slides is an empty array.

Tool

get_slide_screenshot

Returns a JPEG screenshot of a slide in a deck you own. Screenshots are returned directly to your MCP client, without a download URL, and are not saved by Slides. Limited to 120 screenshots per user per hour.

Inputs

deck_id
Integer Required

ID of the deck that owns the slides.

slide_id
String Required

ID of the slide, returned by List slides. Use the ID, not the slide number.

Example Arguments

{
  "deck_id": 456,
  "slide_id": "a1b2c3d4e5f6"
}

Returns

Returns a text metadata block and an image/jpeg content block containing base64-encoded image bytes.

Tool

update_slide

Requires Full access

Replaces one slide’s HTML, notes, or both while preserving its slide ID. Provide at least one of html or notes.

Inputs

deck_id
Integer Required

ID of the deck that owns the slides.

slide_id
String Required

ID of the slide, returned by List slides. Use the ID, not the slide number.

html
String Optional

Complete replacement HTML for one slide, enclosed in one <section> with no nested <section> elements. Read get_authoring_guide before writing slide HTML. Content outside .sl-block elements is wrapped in a text block that fills the slide. Preserve existing .sl-block elements and their data-block-id values. Each .sl-block needs a supported data-block-type and exactly one direct child with class .sl-block-content or .sl-block-style. Omit to keep the current HTML.

notes
String or null Optional

Speaker notes for the slide. Use null to clear existing notes, or omit to keep them.

layout
String Optional

Move the slide to this template layout. Slots you don't fill keep the slide's current content where the new layout has a slot of the same name. Omit to refill the slide's current slots.

fills
Object Optional

Content for the slide's slots, keyed by slot name. Without layout, only the slots you name change; null removes a slot, and a shorter array removes the trailing items of a repeat.

template_id
Integer Optional

Template the layout belongs to. Defaults to the template the deck was created from.

edits
Array Optional

Targeted edits to the slide's current HTML, applied in order, for small changes without resending html. Each edit is one operation: replace_text (old_string, new_string, and replace_all to replace more than one match), replace_block (block_id, html), remove_block (block_id) or add_block (html, optional after_block_id). If any edit fails, or the result is not well-formed HTML, nothing is saved.

Example Arguments

{
  "deck_id": 456,
  "slide_id": "a1b2c3d4e5f6",
  "notes": "Introduce the results."
}

Returns

Returns the slide ID, deck ID, and position without HTML or notes. Use the get_slides tool to retrieve content. Validation failures leave the deck unchanged.

Tool

add_slide

Requires Full access

Creates a slide and returns its ID. By default, adds it at the horizontal end of the deck. To choose a position, provide insert_before_slide_id or insert_after_slide_id. If that slide is in a vertical group, the new slide joins the same group.

Inputs

deck_id
Integer Required

ID of the deck that owns the slides.

html
String Default "<section></section>" Optional

HTML for one slide, enclosed in one <section> with no nested <section> elements. Read get_authoring_guide before writing slide HTML. Content outside .sl-block elements is wrapped in a text block that fills the slide. Preserve existing .sl-block elements and their data-block-id values. Each .sl-block needs a supported data-block-type and exactly one direct child with class .sl-block-content or .sl-block-style. Defaults to an empty <section>.

notes
String or null Optional

Optional speaker notes for the new slide.

insert_before_slide_id
String Optional

Insert before this slide. Cannot be combined with insert_after_slide_id.

insert_after_slide_id
String Optional

Insert after this slide. Cannot be combined with insert_before_slide_id.

layout
String Optional

Name of a template layout from get_template. Use instead of html.

fills
Object Optional

Content for the layout's slots, keyed by slot name as listed by get_template. Text slots take a string with light markup, image slots take an image URL, and repeat slots take an array of objects, one per item.

template_id
Integer Optional

Template the layout belongs to. Defaults to the template the deck was created from.

copy_of_slide_id
String Optional

Duplicate this slide from the same deck, with new slide and block IDs and the same notes unless notes is given. Use instead of html or layout.

Example Arguments

{
  "deck_id": 456,
  "html": "<section><h2>Next steps</h2></section>",
  "insert_after_slide_id": "a1b2c3d4e5f6"
}

Returns

Returns the generated slide ID, deck ID, and position without HTML or notes. Use the get_slides tool to retrieve content.

Tool

move_slides

Requires Full access

Moves slides in the order given in slide_ids. Provide either insert_before_slide_id or insert_after_slide_id, identifying a slide that is not being moved. If that slide is in a vertical group, the moved slides join the same group; otherwise they become horizontal slides.

Inputs

deck_id
Integer Required

ID of the deck that owns the slides.

slide_ids
Array Required

IDs of the slides to change, returned by List slides. Accepts 1–200 unique IDs.

insert_before_slide_id
String Optional

Move the selected slides before this slide. Cannot be combined with insert_after_slide_id.

insert_after_slide_id
String Optional

Move the selected slides after this slide. Cannot be combined with insert_before_slide_id.

Example Arguments

{
  "deck_id": 456,
  "slide_ids": [
    "f6e5d4c3b2a1",
    "a1b2c3d4e5f6"
  ],
  "insert_after_slide_id": "123456abcdef"
}

Returns

Returns count, the number of moved slides. If some requested IDs are not found, the other slides are moved and missing_slide_ids lists the missing IDs. Returns a not-found error if none of the requested slides exist.

Tool

remove_slides

Requires Full access

Removes slides and their speaker notes. Requests that would remove every slide are rejected. A vertical group with only one remaining slide becomes a horizontal slide.

Inputs

deck_id
Integer Required

ID of the deck that owns the slides.

slide_ids
Array Required

IDs of the slides to change, returned by List slides. Accepts 1–200 unique IDs.

Example Arguments

{
  "deck_id": 456,
  "slide_ids": [
    "f6e5d4c3b2a1",
    "a1b2c3d4e5f6"
  ]
}

Returns

Returns count, the number of removed slides. If some requested IDs are not found, the other slides are removed and missing_slide_ids lists the missing IDs. Returns a not-found error if none of the requested slides exist.

Tool

list_deck_shares

Pro or Team account required

Returns all private share links for an owned deck, ordered newest first.

Inputs

deck_id
Integer Required

ID of the deck.

Returns

Private share links are returned in data; meta contains total. Each link includes default and fullscreen URLs.

Tool

create_deck_share

Pro or Team account required Requires Full access

Creates a private share link for an owned private or team-visible deck.

Inputs

deck_id
Integer Required

ID of the deck to create a private share link for.

name
String Default "API Link" Optional

Name identifying the private share link.

password
String Optional

Password recipients must enter before viewing the deck through this link.

expires_at
String or null Optional

ISO 8601 timestamp after which the private share link expires.

notify_on_view
Boolean Default false Optional

Whether to notify the deck owner when the deck is first viewed through this link.

Example Arguments

{
  "name": "Customer review",
  "password": "optional-password",
  "expires_at": "2030-08-01T12:00:00Z",
  "notify_on_view": true,
  "deck_id": 456
}

Returns

Returns the new private share link with default and fullscreen URLs. Passwords are never returned. Each deck is limited to 100 private share links.

Tool

revoke_deck_share

Pro or Team account required Requires Full access

Revokes a private share link for an owned deck.

Inputs

deck_id
Integer Required

ID of the deck.

id
Integer Required

ID of the private share link to revoke.

Example JSON Content

{
  "id": 789,
  "revoked": true
}

Returns

JSON content confirming the private share link ID and revoked state.

Tool

get_analytics

Pro or Team account with Analytics

Returns analytics for decks shared with private links. Without deck_ids, ranks every deck with visits in the period. With deck_ids, reports those decks in order, with the slides that stand out, and adds per-slide figures, each private link and recent visits on request. Team members also get the team's Team-visible and public decks.

Inputs

deck_ids
Array Optional

Up to 10 deck IDs to report on, in this order, to compare them. Omit to rank every deck with visits in the period.

range
String Default 30d Optional

Period ending now: 7d, 30d, 90d, 12m or all. Ignored when from and to are given. Allowed values: 7d, 30d, 90d, 12m, all.

from
String Optional

First day of a custom period, as YYYY-MM-DD. Requires to.

to
String Optional

Last day of a custom period, as YYYY-MM-DD. Requires from.

time_zone
String Default UTC Optional

IANA time zone for day boundaries, such as Europe/Stockholm.

audience
String Default all Optional

Which visits to count: all, external, or internal (by the deck's team, signed in as a member or from one of the team's networks). Allowed values: all, external, internal.

include
Array Optional

Detail to add for up to 5 deck_ids: slides, links, visits.

sort
String Default visits Overview only Optional

How the overview is ranked, highest first: visits, unique_viewers, total_view_seconds, median_visit_seconds or last_visit_at. Allowed values: visits, unique_viewers, total_view_seconds, median_visit_seconds, last_visit_at.

page
Integer Default 1 Optional

Overview page number. Minimum: 1.

per_page
Integer Default 20 Optional

Overview decks per page, up to 50. Range: 1–50.

Example Arguments

{
  "deck_ids": [
    456,
    457
  ],
  "range": "90d"
}

Example Arguments

{
  "deck_ids": [
    456
  ],
  "include": [
    "slides",
    "links"
  ]
}

Returns

Each deck in data has deck, period, summary (visits, unique_viewers, total_view_seconds, median_visit_seconds, median_furthest_slide_number, reached_end_rate, visits_by_device, first_visit_at, last_visit_at) and previous, the same summary for the period of equal length just before (null for all time). Named decks add highlights (most_time, biggest_drop_off, most_revisited) and any requested slides, links and visits. Slide IDs work with get_slides and get_slide_screenshot; link IDs with list_deck_shares. Each visit says whether it was internal. Durations are whole seconds, rates run from 0 to 1, and times are UTC. The overview's meta has sort, page, per_page, total and audience; named decks' meta lists missing_deck_ids and has audience.

Tool

create_deck_export

Requires Full access

Starts an asynchronous PDF or ZIP export for an owned deck.

Inputs

deck_id
Integer Required

Deck ID to export.

format
String Required

Export format: pdf or zip. Allowed values: pdf, zip.

margin
Number Default 0.0 PDF only Optional

PDF-only page margin between 0 and 0.2. Range: 0–0.2.

slide_number
Boolean Default false PDF only Optional

PDF-only option that includes slide numbers.

slide_notes
Boolean Default false PDF only Optional

PDF-only option that includes speaker notes.

separate_fragments
Boolean Default false PDF only Optional

PDF-only option that prints fragment steps separately.

Rate limit

Export creation is limited to 10 exports per user per hour. Polling uses the standard API rate limit.

Example Arguments

{
  "format": "pdf",
  "margin": 0.05,
  "slide_number": true,
  "slide_notes": false,
  "separate_fragments": false,
  "deck_id": 456
}

Returns

Returns a pending export; meta contains poll_after_seconds.

Tool

get_deck_export

Returns the current state of a PDF or ZIP export for an owned deck.

Inputs

deck_id
Integer Required

Deck ID that owns the export.

id
Integer Required

Export ID to retrieve.

Polling

Pending responses include poll_after_seconds in meta. Poll again after that interval.

Returns

Returns a pending, completed, or failed export. Completed exports include a temporary download URL and its expiration time.

Tool

list_team_decks

Team admin or owner required

Returns team-visible and public decks from the authenticated user’s team.

Inputs

page
Integer Default 1 Optional

Page number to return. Minimum: 1.

per_page
Integer Default 20 Optional

Number of records to return per page, up to a maximum of 100. Range: 1–100.

Returns

Deck summaries are returned in data; meta contains page, per_page, and total. Every summary includes visibility and deck owner identity; MCP results include only the owner’s display name.

Tool

get_team_deck

Team admin or owner required

Returns a team-visible or public deck.

Inputs

id
Integer Required

ID of the team deck.

include_deck_html
Boolean Default false Optional

Whether to include deck_html, which contains the HTML for all slides in the deck.

Returns

Returns the same fields as get_deck, plus deck owner identity (MCP results include only the owner’s display name). deck_html is present only when include_deck_html is true.