Beautiful.ai API and MCP server

• POST

  list_presentations

  Presentations in your library and shared folders, newest first, with folder, slide count and owner.

  read

  Returns decks you can open, newest first. Filter by title keyword or folder. Pass presentation_id from each item to the other tools. Pages hold up to 100 decks.

  POST /api/v1/beautiful-ai/list_presentations

  Input

  Input: list_presentations

  Parameter	Type	Description
  query	string	Search titles.
  folder	string	Only presentations in this folder.
  limit	integer	1 to 100. Default: 25.

  Example response

  {
    "presentations": [
      {
        "presentation_id": "pres_8f3k2m9q",
        "title": "Q3 QBR",
        "folder": "Sales",
        "slides": 18,
        "owner": "You",
        "updated_at": "2026-10-08T14:20:00Z"
      },
      {
        "presentation_id": "pres_2q7w1x5c",
        "title": "Investor update",
        "folder": null,
        "slides": 12,
        "owner": "You",
        "updated_at": "2026-10-05T09:02:00Z"
      }
    ]
  }

• POST

  list_folders

  Your folders, including shared workspace folders, with the number of decks in each.

  read

  Returns folders by name with deck counts. Use the name as the folder parameter of list_presentations and move_to_folder.

  POST /api/v1/beautiful-ai/list_folders

  Input

  No parameters.

  Example response

  {
    "folders": [
      {
        "name": "Sales",
        "presentations": 14,
        "shared": true
      },
      {
        "name": "Board",
        "presentations": 6,
        "shared": false
      }
    ]
  }

• POST

  get_slides

  Every slide in order: layout, text, speaker notes and whether it is skipped.

  read

  Returns the slides of one deck in order, starting at 1. Text is listed in reading order per slide. Use it before update_slide_text so your agent sees what is on each slide.

  POST /api/v1/beautiful-ai/get_slides

  Input

  Input: get_slides

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.

  Example response

  {
    "presentation_id": "pres_8f3k2m9q",
    "slides": [
      {
        "slide_number": 1,
        "layout": "Title",
        "text": [
          "Q3 QBR",
          "Sales team"
        ],
        "speaker_notes": "",
        "skipped": false
      },
      {
        "slide_number": 4,
        "layout": "Bullets",
        "text": [
          "FY25 targets",
          "Grow ARR 40%",
          "Launch in two new regions"
        ],
        "speaker_notes": "Mention the EU launch date.",
        "skipped": false
      }
    ]
  }

• POST

  get_presentation_analytics

  Viewer and slide analytics for a deck, as the app shows them.

  read

  Returns the viewer and slide analytics Beautiful.ai shows for one deck. Availability depends on your plan; without it the call fails with an error that names the plan.

  POST /api/v1/beautiful-ai/get_presentation_analytics

  Input

  Input: get_presentation_analytics

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.

  Example response

  {
    "presentation_id": "pres_8f3k2m9q",
    "views": 14,
    "unique_viewers": 9,
    "slides": [
      {
        "slide_number": 1,
        "views": 14
      },
      {
        "slide_number": 4,
        "views": 11
      }
    ]
  }

• POST

  list_collaborators

  People with access to a presentation and whether they can edit or view.

  read

  Returns each person with access to the deck, with email and permission. Use the email in remove_collaborator.

  POST /api/v1/beautiful-ai/list_collaborators

  Input

  Input: list_collaborators

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.

  Example response

  {
    "presentation_id": "pres_8f3k2m9q",
    "collaborators": [
      {
        "email": "anna@example.com",
        "permission": "can_edit"
      },
      {
        "email": "tom@example.com",
        "permission": "can_view"
      }
    ]
  }

• POST

  update_slide_text

  Replace text on one slide, keeping its Smart Slide layout.

  write

  Replaces exact text on one slide and keeps its layout. Returns the number of matches replaced and the slide text after the change. It reaches no one and one call undoes it, so it runs without asking.

  POST /api/v1/beautiful-ai/update_slide_text

  Input

  Input: update_slide_text

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.
  slide_number required	integer	Slide position in the deck, starting at 1.
  find required	string	Exact text to replace.
  replace required	string	New text.

  Example response

  {
    "presentation_id": "pres_8f3k2m9q",
    "slide_number": 4,
    "replaced": 1,
    "slide_text": [
      "FY26 targets",
      "Grow ARR 40%",
      "Launch in two new regions"
    ]
  }

• POST

  set_speaker_notes

  Write or replace the speaker notes of a slide.

  write

  Replaces the speaker notes of one slide with the text you send. An empty string clears them. It reaches no one and one call undoes it, so it runs without asking.

  POST /api/v1/beautiful-ai/set_speaker_notes

  Input

  Input: set_speaker_notes

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.
  slide_number required	integer	Slide position in the deck, starting at 1.
  notes required	string	Notes text. Empty string clears them.

  Example response

  {
    "presentation_id": "pres_2q7w1x5c",
    "slide_number": 2,
    "speaker_notes": "Open with the churn drop. Pause for questions before the pricing slide."
  }

• POST

  skip_slide

  Skip or unskip a slide when presenting.

  write

  Marks one slide as skipped, so it is left out when presenting, or shows it again. It reaches no one and one call undoes it, so it runs without asking.

  POST /api/v1/beautiful-ai/skip_slide

  Input

  Input: skip_slide

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.
  slide_number required	integer	Slide position in the deck, starting at 1.
  skipped required	boolean	true to skip, false to show it again.

  Example response

  {
    "presentation_id": "pres_2q7w1x5c",
    "slide_number": 7,
    "skipped": true
  }

• POST

  duplicate_presentation

  Copy any presentation in your library, as the Duplicate menu item does.

  write

  Creates a copy of the deck in your library and returns its ID. The copy is private to you until you share it, so it runs without asking.

  POST /api/v1/beautiful-ai/duplicate_presentation

  Input

  Input: duplicate_presentation

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.
  title	string	Title of the copy. Default: same as the original.

  Example response

  {
    "presentation_id": "pres_9k4m6b2v",
    "source_id": "pres_5d9a4r1t",
    "title": "Sales review, November",
    "slides": 16
  }

• POST

  move_to_folder

  Put a presentation in one of your folders.

  write

  Moves a deck into a folder from list_folders. People with access to that folder can then see it. One call moves it back, so it runs without asking.

  POST /api/v1/beautiful-ai/move_to_folder

  Input

  Input: move_to_folder

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.
  folder required	string	Folder name from list_folders.

  Example response

  {
    "presentation_id": "pres_9k4m6b2v",
    "folder": "Sales"
  }

• POST

  export_presentation

  Export the deck and return a download link.

  write

  Exports one deck and returns a download link. Formats follow your Beautiful.ai plan. The export changes nothing in the deck and reaches no one, so it runs without asking.

  POST /api/v1/beautiful-ai/export_presentation

  Input

  Input: export_presentation

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.
  format required	enum	pdf or pptx.

  Example response

  {
    "presentation_id": "pres_2q7w1x5c",
    "format": "pdf",
    "download_url": "https://www.beautiful.ai/export/exp_71c0aa.pdf"
  }

• POST

  invite_collaborator

  Invite someone by email to edit or view a presentation. They get an email.

  asks first write

  Gives one person access to the deck and emails them. Permission is can_edit or can_view. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/beautiful-ai/invite_collaborator

  Input

  Input: invite_collaborator

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.
  email required	string	Email of the person to invite.
  permission required	enum	can_edit or can_view.

  Example response

  {
    "presentation_id": "pres_8f3k2m9q",
    "email": "anna@example.com",
    "permission": "can_edit",
    "status": "invited"
  }

• POST

  remove_collaborator

  Revoke a collaborator's access to a presentation.

  asks first write

  Removes one person from the deck. They lose access at once. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/beautiful-ai/remove_collaborator

  Input

  Input: remove_collaborator

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.
  email required	string	Email from list_collaborators.

  Example response

  {
    "presentation_id": "pres_8f3k2m9q",
    "email": "tom@example.com",
    "status": "removed"
  }

• POST

  create_share_link

  Share the presentation and return a link to it.

  asks first write

  Makes the deck viewable through a link and returns the link. Anyone who gets the link can open the deck. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/beautiful-ai/create_share_link

  Input

  Input: create_share_link

  Parameter	Type	Description
  presentation_id required	string	Presentation ID from list_presentations.
  name	string	Link name, to tell links apart.

  Example response

  {
    "presentation_id": "pres_8f3k2m9q",
    "name": "Investors",
    "url": "https://www.beautiful.ai/player/pres_8f3k2m9q",
    "status": "shared"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.