Set up Clueso MCP

The Clueso MCP server lets your AI assistant create and manage Clueso projects without leaving your chat or coding environment. Once connected, you can ask your assistant to create a new project, update a project, add voiceovers, export videos, and more — all through natural language.

Before you start

To use the Clueso MCP server, you’ll need:

An AI assistant that supports MCP servers, such as:
- ChatGPT
- Claude
- Claude Code
- Gemini CLI
- Cursor
- VS Code (with GitHub Copilot or a compatible MCP extension)
A Clueso account

The Clueso MCP server is available on all Clueso plans. Some tools — such as video export and advanced branding - require a paid plan.

Connect your AI assistant

This setup requires a ChatGPT paid plan (Plus, Pro, Team, Enterprise, or Edu). A paid ChatGPT plan is recommended for better outputs

Open ChatGPT and go to Settings.
Click Apps, then enable Developer Mode.
Click Add (or Create) and enter the following URL: https://connect.clueso.io/mcp
Name it Clueso and save.
A browser window will open — sign in to Clueso and click Allow to authorize.
In the chat, click the + icon below the chatbox, hover over More, and select Developer mode to activate Clueso for that chat.

Test it:

“Create a Clueso guide from this PPT, add a voiceover to each slide explaining the key point, and export it as a video.”

Run the following command in your terminal to add the Clueso MCP server to Claude Code:

claude mcp add --transport http Clueso https://connect.clueso.io/mcp

Claude Code will prompt you to authorize Clueso in your browser. Sign in and click Allow.

You can also scope the MCP server to a specific project by running the command inside that project’s directory and adding the --scope project flag.

To verify the server was added:

claude mcp list

You should see Clueso listed with a ✓ connected status.Test it by starting a session:

claude

“Create a Clueso guide from this PPT, add a voiceover to each slide explaining the key point, and export it as a video.”

For full Claude Code MCP documentation, see Anthropic’s Claude Code MCP docs.

Gemini CLI MCP support requires Gemini CLI version 0.1.7 or later. Run gemini --version to check.

Open your terminal and navigate to your project directory.
Add the Clueso MCP server to your Gemini CLI settings:

gemini mcp add clueso https://connect.clueso.io/mcp

Gemini CLI will open a browser window for you to authorize Clueso. Sign in and click Allow.

Alternatively, you can manually configure Gemini CLI by editing ~/.gemini/settings.json:

~/.gemini/settings.json

{
  "mcpServers": {
    "clueso": {
      "httpUrl": "https://connect.clueso.io/mcp",
      "timeout": 10000
    }
  }
}

Test it:

gemini

“Show me all projects in my Clueso workspace.”

For more on Gemini CLI, see the Gemini CLI GitHub repo.

MCP tools in Cursor are only available in Agent mode. Make sure you’re in an Agent chat session.

Requires Node.js 22.16 or later with npm. Download Node.js →

Option 1 — Automatic setup (recommended)

Click the link below to auto-configure Clueso in Cursor:

cursor://anysphere.cursor-deeplink/mcp/install?name=Clueso&config=eyJjb21tYW5kIjoibnB4IC15IG1jcC1yZW1vdGVAbGF0ZXN0IGh0dHBzOi8vY29ubmVjdC5jbHVlc28uaW8vbWNwIn0=

Option 2 — Manual setup

Create the Cursor config directory in your project root (if it doesn’t exist):

mkdir -p .cursor && touch .cursor/mcp.json

Add the following to .cursor/mcp.json:

.cursor/mcp.json

{
  "mcpServers": {
    "Clueso": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://connect.clueso.io/mcp"
      ]
    }
  }
}

Restart Cursor to apply the config.
A browser tab will open — sign in to Clueso and click Allow.

Test it by opening an Agent chat:

“Create a new Clueso project in the Onboarding folder.”

For more details, see the Cursor MCP documentation.

MCP tools in VS Code require GitHub Copilot (or another compatible MCP extension) and are only available in Agent mode.

Requires Node.js 22.16 or later with npm. Download Node.js →

Create the VS Code config directory in your project root (if it doesn’t exist):

mkdir -p .vscode && touch .vscode/mcp.json

Add the following to .vscode/mcp.json:

.vscode/mcp.json

{
  "servers": {
    "Clueso": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://connect.clueso.io/mcp"
      ]
    }
  }
}

Restart VS Code to apply the configuration.
A browser tab will open — sign in to Clueso and click Allow to authorize.

Test it by opening a GitHub Copilot Agent chat:

“List all guides in my Clueso workspace.”

For more details, see the VS Code MCP documentation.

Verify the connection

After setup, confirm the Clueso MCP server is working:

Look for the Clueso tool in your AI assistant’s tools or connectors panel.
Run a test prompt, for example:
“Show me my most recently updated Clueso project.”
Your AI assistant should ask you to approve a tool call. Click Allow (or Approve) and wait for the response.

If the connection is successful, you’ll see a list of your Clueso projects returned in the chat.

If the connection fails or times out, try restarting your AI assistant and re-authorizing. Make sure you’re signed into Clueso in your browser.

What you can do with Clueso MCP

Once connected, you can ask your AI assistant to:

Create projects

“Create a new video called ‘How to reset your password’.”

Add voiceovers

“Add a voiceover to the first clip of my onboarding guide.”

Export videos

“Export my ‘Getting Started’ project as a video.”

Update articles

“Update the article in my ‘API Docs’ project with this new content.”

Tools available

Your AI assistant can call the following Clueso tools once connected. You don’t need to memorize them — just describe what you want and your assistant will pick the right ones. This list is provided as a reference for what’s possible.

Workspaces and projects

Tool	What it does
`list_workspaces`	List all Clueso workspaces you have access to.
`switch_workspace`	Switch to a different workspace for the current session.
`list_projects`	Browse video, image, and article projects in your workspace.
`list_folders`	List folders in your workspace.
`create_project`	Create a new video, image, or article project.
`get_project_data`	Read the full structure of a project (clips, elements, voiceovers).
`update_project`	Rename a project or move it between folders.

Clips

Tool	What it does
`add_blank_clips`	Add empty clips to a project.
`add_pptx_clips`	Import a PowerPoint deck as one clip per slide.
`add_video_clip`	Add a video file as a clip.
`get_clip_details`	Inspect a clip and optionally return a rendered preview.
`update_clip`	Change a clip’s background, duration, or layout.
`split_clip`	Split a clip into two at a chosen point.
`remove_clip`	Delete a clip from a project.
`reorder_clips`	Rearrange the order of clips.

Elements (text, images, shapes, animations)

Tool	What it does
`add_elements`	Place text, images, shapes, or animations onto a clip.
`update_elements`	Edit the position, size, or content of existing elements.
`get_element_schema`	Show the properties available for a given element type.

Voiceover and audio

Tool	What it does
`voiceover_batch`	Generate AI voiceovers for one or many clips from a script.
`set_voice`	Pick the AI voice used for narration.
`add_audio`	Add background music or a sound effect to a project.
`search_audio`	Search Clueso’s built-in music and SFX library.
`analyze_audio`	Get a transcript and analysis of an audio file.

Articles

Tool	What it does
`get_article`	Read the article tied to a project.
`update_article`	Edit the article’s content.
`add_article_image`	Add an image to an article.
`update_article_image`	Replace or reposition an image in an article.
`get_article_image`	Fetch a specific article image.
`add_article_gif`	Add an animated GIF to an article.

Recording

Tool	What it does
`record`	Start a new screen or browser recording in Clueso.

Motion graphics

Tool	What it does
`animation_code`	Generate a custom animated element from a natural-language prompt.

Files and assets

Tool	What it does
`upload`	Upload a file (image, video, audio, PPTX) to your workspace.
`check_uploads`	Check the status of in-progress uploads.
`list_assets`	Browse uploaded assets in your workspace.

Clueprints (reusable templates)

Tool	What it does
`list_clueprints`	Browse available clueprint templates.
`create_clueprint`	Save a project as a reusable clueprint.
`use_clueprint`	Apply a clueprint to a project.
`get_clueprint_data`	List files inside a clueprint.
`read_clueprint_files`	Read the design data inside clueprint files.
`write_clueprint_files`	Write or update files inside a clueprint.
`update_clueprint_metadata`	Edit a clueprint’s title or description.
`delete_clueprint_files`	Remove files from a clueprint.

Collaboration

Tool	What it does
`add_comment`	Leave a comment on a project.

Export

Tool	What it does
`estimate_duration`	Estimate the final duration of a project.
`trigger_export`	Render and export a project as a video.

Combine tools for end-to-end workflows

The real power of Clueso MCP comes from chaining these tools together. Your AI assistant can call several tools in sequence to complete a full workflow — no manual hand-offs, no copying assets between tools. Just describe the outcome you want, and the assistant figures out which tools to call and in what order. A few examples:

“Turn this slide deck into a narrated explainer video.” Uploads the PPTX (upload), creates a project (create_project), imports each slide as a clip (add_pptx_clips), generates AI narration per slide (voiceover_batch), then renders the final video (trigger_export).
“Build a product release video from this changelog.” Creates a project (create_project), adds clips (add_blank_clips), drops in headlines and screenshots (add_elements), generates a voiceover from the script (voiceover_batch), and exports it (trigger_export).
“Convert this Loom recording into a polished Clueso guide.” Uploads the recording (upload), adds it as a clip (add_video_clip), splits it into chapters (split_clip), layers titles and zoom callouts (add_elements), regenerates cleaner narration (analyze_audio → voiceover_batch), and exports the result (trigger_export).
“Make five persona-specific versions of this video from our base template.” Picks the template (list_clueprints → use_clueprint), spawns five projects (create_project), tweaks the voiceover script per persona (voiceover_batch), and exports all five (trigger_export).
“Refresh every onboarding video with our new brand colors.” Walks your workspace (list_projects → get_project_data), updates each clip background and element style in place (update_clip, update_elements), and re-exports the affected videos (trigger_export).

Troubleshooting

The Clueso connector doesn't appear in my AI assistant

Make sure you’ve restarted your AI assistant after saving the configuration.
For MCP server setups (Cursor, VS Code, and Claude code), verify Node.js 22.16+ is installed by running node --version.
Check that the MCP server URL https://connect.clueso.io/mcp is correct in your config file.

Authorization keeps failing

Make sure you’re logged into Clueso at web.clueso.io in your browser before authorizing.
Try clearing your browser cookies and re-authorizing.

Tool calls time out or return errors

Confirm your Clueso account is active and your workspace is accessible.
Check your internet connection and any firewall rules that might block connect.clueso.io.
Try removing and re-adding the MCP server, then re-authorizing.

MCP tools don't appear in Cursor or VS Code

In Cursor, make sure you’re in Agent mode, not normal chat.
In VS Code, make sure GitHub Copilot is active and you’re in an Agent chat (@workspace or the agent panel).
Restart the editor after any config changes.

Getting started

Home

Screen recording

Voiceovers

Sync points

Editing

Elements

Article

Languages and Translation

Account

Before you start

Connect your AI assistant

Option 1 — Automatic setup (recommended)

Option 2 — Manual setup

Verify the connection

What you can do with Clueso MCP

Create projects

Add voiceovers

Export videos

Update articles

Tools available

Workspaces and projects

Clips

Elements (text, images, shapes, animations)

Voiceover and audio

Articles

Recording

Motion graphics

Files and assets

Clueprints (reusable templates)

Collaboration

Export

Combine tools for end-to-end workflows

Troubleshooting

Getting started

Home

Screen recording

Voiceovers

Sync points

Editing

Elements

Article

Languages and Translation

Account

Documentation Index

​Before you start

​Connect your AI assistant

​Option 1 — Automatic setup (recommended)

​Option 2 — Manual setup

​Verify the connection

​What you can do with Clueso MCP

Create projects

Add voiceovers

Export videos

Update articles

​Tools available

​Workspaces and projects

​Clips

​Elements (text, images, shapes, animations)

​Voiceover and audio

​Articles

​Recording

​Motion graphics

​Files and assets

​Clueprints (reusable templates)

​Collaboration

​Export

​Combine tools for end-to-end workflows

​Troubleshooting

Before you start

Connect your AI assistant

Option 1 — Automatic setup (recommended)

Option 2 — Manual setup

Verify the connection

What you can do with Clueso MCP

Tools available

Workspaces and projects

Clips

Elements (text, images, shapes, animations)

Voiceover and audio

Articles

Recording

Motion graphics

Files and assets

Clueprints (reusable templates)

Collaboration

Export

Combine tools for end-to-end workflows

Troubleshooting