Beautiful.ai MCP Connector: Setup & FAQ

The Beautiful.ai MCP connector lets supported AI assistants securely interact with Beautiful.ai presentations, templates, folders, and themes. Once connected, users can search existing decks, summarize presentation content, create new presentations from structured prompts, generate decks from templates, and export presentations as PDF or PPTX.

For full API reference and advanced usage, see the developer docs:
https://docs.beautiful.ai/reference/createpresentation-1

Production MCP URL

https://openai-mcp-696419881849.us-central1.run.app/mcp

OAuth Provisioning URL

https://www.beautiful.ai/provisioning/oauth2

What is the Beautiful.ai MCP connector?

MCP, or Model Context Protocol, is a standard that allows AI assistants to connect with external applications using approved tools. The Beautiful.ai MCP connector gives an AI assistant permissioned access to Beautiful.ai actions on behalf of the authenticated user.

After setup, the assistant can help users:

• Search for presentations and templates
• Open presentation metadata and playback links
• Create new decks from outlines
• Create decks from templates
• Export presentations
• List folders and themes
• Inspect template variables

The connector only works for users who authenticate with Beautiful.ai through OAuth.

Authentication and Access

Beautiful.ai MCP uses OAuth 2.0 for authentication.

When a user connects the MCP server, they are redirected through the Beautiful.ai OAuth provisioning flow:

https://www.beautiful.ai/provisioning/oauth2

During this flow, the user signs in to Beautiful.ai and grants the connector access to act on their behalf. Once authorized, the AI assistant receives access through a secure token rather than the user's password.

The connector respects the authenticated user's existing Beautiful.ai permissions. Users can only access presentations, templates, folders, workspaces, and themes that their Beautiful.ai account is allowed to access.

What permissions are requested?

The connector requires read and write access so it can both retrieve existing Beautiful.ai content and create or export new content.

Read access is used to:

• Search and retrieve presentations
• List templates, folders, and themes
• Inspect template variables
• Open accessible presentation metadata

Write access is used to:

• Create new presentations
• Copy templates into a workspace
• Generate presentations from structured outlines
• Export presentations to PDF or PPTX

Does the MCP connector store my Beautiful.ai password?

No. Users authenticate through Beautiful.ai's OAuth flow. The AI assistant and MCP connector do not receive or store the user's Beautiful.ai password.

Can users access private decks?

Only if the authenticated Beautiful.ai user already has access to those decks. The connector follows the same permission model as Beautiful.ai.

Can the connector access team workspaces?

Yes, when the authenticated user has access to those workspaces in Beautiful.ai. Available team folders, team themes, presentations, and templates may be returned by the connector according to the user's permissions.

Setup Instructions

Claude Desktop or Claude-compatible MCP clients

Add the Beautiful.ai MCP server using the production MCP URL:

https://openai-mcp-696419881849.us-central1.run.app/mcp

When prompted, complete the OAuth flow with your Beautiful.ai account. After authorization, the Beautiful.ai tools should become available inside the assistant.

OpenAI / ChatGPT app environments

Use the Beautiful.ai connector through the ChatGPT app integration. Once connected, mention or select Beautiful.ai in chat and ask the assistant to create, search, summarize, or export Beautiful.ai presentations.

Example:

Available Tools

1. get_themes

Returns built-in, saved, and team themes available to the authenticated user.

Use this when a user wants to browse brand themes, select a visual style, or confirm which workspace themes are available.

Example prompts:

• Show me the Beautiful.ai themes I can use.
• Create a deck using our Company Brand Theme_2025.

2. get_folders

Returns the user's available Beautiful.ai folders, including personal folders and team folders.

Use this when a user wants to save a generated presentation in a specific location.

Example prompts:

• Show me the folders I can save Beautiful.ai decks into.
• Create this presentation in our Sales Enablement folder.

3. list_presentations

Lists or searches presentations and presentation templates available to the authenticated user.

Use this when a user wants to find an existing deck, locate a template, or search by title or keyword.

Example prompts:

• Find my Q2 board update deck.
• Search for presentations about enterprise sales enablement.
• Find the latest product launch deck I have access to.

4. list_presentation_templates

Lists available Beautiful.ai presentation templates.

Use this when a user wants to start from a reusable template instead of creating a deck from scratch.

Example prompts:

• Show me available sales proposal templates.
• Find a template I can use for a customer business review.

5. get_presentation

Retrieves an existing Beautiful.ai presentation that the authenticated user can access. It returns presentation playback information and, when permitted, editor and export availability.

Use this when a user wants to open or inspect a specific presentation.

Example prompts:

• Open the product roadmap presentation.
• Get the playback link for my investor update deck.

6. get_presentation_template_variables

Scans a presentation template for ${variable} placeholders and returns the variable inventory.

Use this when a user wants to understand which fields are required before generating a deck from a template.

Example prompts:

• What variables does this proposal template need?
• Inspect this template and tell me what information I need to provide.

7. review_presentation_outline

Builds a review package for a structured presentation outline and selected generation options. This is useful for previewing the planned deck before creating it.

Use this when a user wants to review the structure, slide types, theme options, or image options before generation.

Example prompts:

• Review a 7-slide outline for a new customer onboarding deck before creating it.
• Draft an outline for a product launch deck and let me approve it first.

8.create_presentation

Creates a Beautiful.ai presentation from a structured outline. Each slide includes a title, summary, and slide type. The tool can also use a folder, theme, image source, image style, language, and exact-text preservation setting.

Use this when a user wants to generate a new deck from a prompt, notes, transcript, launch plan, strategy memo, or meeting summary.

Example prompts:

• Create a 6-slide pitch deck from this product launch plan using a bold executive tone.
• Turn these meeting notes into a recap deck with goals, decisions, action items, and next steps.
• Create a product strategy presentation in Beautiful.ai using a dark background and modern typography.

9. create_presentation_from_template

Copies a presentation template into its owning workspace. This is used to create a new presentation based on an existing template.

Use this when a user wants to reuse an approved brand or workflow template.

Example prompts:

• Create a new presentation from our sales proposal template.
• Copy the customer business review template so I can customize it for Acme Corp.

10. export_presentation

Exports a Beautiful.ai presentation to PDF or PPTX and returns a temporary signed download URL. The authenticated user must have download access to the presentation.

Use this when a user wants to share, archive, upload, or edit a Beautiful.ai deck outside Beautiful.ai.

Example prompts:

• Export my Series B Fundraise deck as a PPTX.
• Download the QBR deck as a PDF with skipped slides included.

Common Use Cases

1. Find and summarize existing presentations

Users can ask the assistant to locate presentations they have access to and summarize the content or purpose.

Example prompts:

• Find my Q2 board update deck and summarize the key takeaways, risks, and open questions.
• Search for presentations about customer onboarding and tell me which one looks most recent.

2. Create a new presentation from a conversation

Users can turn notes, ideas, meeting transcripts, product requirements, or strategy documents into a polished Beautiful.ai deck.

Example prompts:

• Create a 6-slide pitch deck from this product launch plan using our Marketing Theme.
• Turn this meeting transcript into a polished recap deck with sections for decisions, risks, owners, and next steps.

3. Generate a deck from a template

Users can find an approved template and create a new presentation from it.

Example prompts:

• Find our sales proposal template and create a new copy for Acme Corp.
• Use the customer business review template to create a new presentation for my Q1 account review.

4. Use brand-approved themes

Users can list available themes and create decks using built-in, saved, or team themes.

Example prompts:

• Show me the themes I can use in Beautiful.ai.
• Create a product strategy deck using the Company Brand Theme_2025.

5. Export presentations

Users can export accessible presentations to PDF or PPTX.

Example prompts:

• Export my investor update deck as a PDF.
• Export the sales kickoff presentation as a PPTX, including skipped slides.

FAQ

Who can use the Beautiful.ai MCP connector?

Any user with a Beautiful.ai account who can authenticate through the OAuth provisioning flow and whose AI assistant or MCP client supports remote MCP servers.

What URL should I use for setup?

Use the production MCP URL:

https://openai-mcp-696419881849.us-central1.run.app/mcp

Where does OAuth happen?

OAuth provisioning happens at:

https://www.beautiful.ai/provisioning/oauth2

Why do I need to sign in?

Signing in confirms your Beautiful.ai identity and allows the connector to act on your behalf. This lets the assistant access only the content and actions available to your account.

Can the assistant create presentations automatically?

Yes. The assistant can create presentations from a structured outline using the create_presentation tool. Some clients may choose to review the outline with the user before creating the deck.

Can the assistant edit an existing deck?

The current toolset supports finding, opening, copying from templates, creating new presentations, and exporting. It does not provide full arbitrary slide-by-slide editing of an existing presentation.

Can the connector export to Google Slides?

The current export tool supports PDF and PPTX. Users can export to PPTX and then import that file into Google Slides.

Can it export skipped slides?

Yes. The export tool supports an option to include skipped slides when exporting.

Can it generate images?

When creating a presentation, generation options may include an image source such as AI, web, stock, or none, depending on the client flow and selected options.

Does it support multiple languages?

The presentation creation tool supports a language option when generating a new deck.

What happens if a user cannot find a deck?

First, confirm the user is signed in with the correct Beautiful.ai account. Then confirm the user has access to the workspace or folder containing the deck. The connector can only return presentations available to the authenticated account.

What should users do if authentication fails?

Ask the user to reconnect the Beautiful.ai MCP server and complete the OAuth flow again. They should make sure they are signing in with the correct Beautiful.ai account.

What should users do if export fails?

Confirm that the user has download access to the presentation. If they can view the deck but do not have download permission, the export tool may not be available.