Skip to main content
Install the Stewdio plugin to create and edit motion graphics with your agent. It bundles a stewdio skill and an MCP server at https://mcp.stewdio.ai/mcp using Streamable HTTP and OAuth. An MCP connection alone does not install the skill. You need a Stewdio account. Creating and editing Files depends on your Stewdio plan. The Stewdio desktop application is optional. Plugin marketplace: StewdioAI/plugin. Look for Stewdio in your host’s plugin directory first; use the repository if no listing is available. No ZIP download or build is needed.

​
Installation stages for the agent

Treat a request to follow this guide as a request to install the plugin. Complete these stages using only the matching host instructions below:
  1. Identify the host. Use explicit runtime, session, or user information to identify the app and whether it is web, desktop, or CLI. Model names, available tools, and installed CLIs do not identify the host. A web sandbox cannot configure the user’s local CLI. If unclear, ask: “Which app are you using: ChatGPT web, Claude web, ChatGPT desktop, Claude desktop, Claude Code CLI, Codex CLI, or another coding agent?” Ask for the other agent’s name if needed.
  2. Check requirements and existing setup. Check host plan and workspace restrictions. Inspect installed plugins and skills, matching the repository and server URL above. Reuse the plugin and authenticated connection where supported; preserve other configuration and conflicting entries.
  3. Install. In web and desktop apps, use available UI controls or guide the user through the next few clicks. In CLI agents, execute inspection and installation commands in that agent’s environment. If blocked, explain why and provide the exact command for the user.
  4. Authenticate. Let the user complete OAuth sign-in and consent in their browser. Never request passwords or access tokens in chat.
  5. Start a new session. Explicitly ask the user to start a new conversation or CLI session with Stewdio enabled to load its skill and tools. Give them the one-click starter link or command from Start a new session. Continue pending verification there.
  6. Verify. Follow the verification checks below before reporting success.

​
Claude web and desktop

Plugins require Pro, Max, Team, or Enterprise. Explain this to Free users before installation; offer another supported client if they prefer not to upgrade.
  1. Open Customize > Plugins > Discover, find Stewdio, and choose Add.
  2. If missing, choose Add > Add marketplace > Add from a repository, enter https://github.com/StewdioAI/plugin, and sync. Open Stewdio in that marketplace and choose Add or Install.
  3. Enable the plugin, select its server’s Connect action, and complete sign-in and consent.
Reuse an existing installation in the same Claude account. Account plugins sync to Claude Code v2.1.273 or later with Claude account sign-in, but not API-key or cloud-provider sign-in. If repository access is restricted, ask an organization owner to allow the marketplace. If UI labels differ, check the official Claude plugin guide before proceeding.

​
ChatGPT web and desktop

Open Plugins, find Stewdio, and check its source and bundled skill. If available for your account, workspace, and surface, select the plus button to install and connect its server through browser sign-in and consent. If unavailable, a workspace admin with Admin > Plugins access and a GitHub account that can read the repository can import it. The plugin’s .mcp.json makes the imported plugin Desktop only, even with a remote HTTPS server. The import does not enable it in ChatGPT web. The admin completes these steps in ChatGPT web:
  1. Open Admin > Plugins > Add > Import marketplace.
  2. Set Source to https://github.com/StewdioAI/plugin. Leave Path and Branch, tag, or commit empty.
  3. Select Import marketplace and authorize GitHub access.
  4. In Import results, open Stewdio and set Installation policy to Available or Installed for the intended role. Enable required apps and confirm user access.
  5. Have the user install Stewdio from Plugins in ChatGPT desktop if needed and complete their own Stewdio sign-in and consent.
ChatGPT web requires an available web-compatible Stewdio plugin. If no plugin or admin import is available, explain the limitation and offer paid Claude or Codex CLI. Do not invent a ZIP upload flow, treat Add custom MCP server as a complete plugin installation, or send end users to the developer submission portal. If UI labels differ, check the official guides: plugin installation and marketplace import, policies, and desktop restrictions.

​
Claude Code CLI

Inspect existing installations, including plugins synced from the Claude account:
If missing, install on v2.1.292 or later:
On older versions, run each command only if its marketplace or plugin is missing:
In interactive sessions on v2.1.275 or later, /plugin install stewdio --marketplace StewdioAI/plugin is an alternative; choose user scope. Follow reload prompts, then have the user open /mcp, select the plugin’s Stewdio server, and authenticate. Slash commands run inside Claude Code, not in a shell. Reference: Claude Code plugin guide.

​
Codex CLI

In an interactive session, open /plugins, find Stewdio, check its source, and install it if available. For terminal setup or when no listing is available, inspect:
Add the marketplace if missing:
Install the plugin if missing:
Complete authentication prompts. In the new session, use /plugins and /mcp to check that Stewdio is enabled and authenticated. Slash commands run inside Codex, not in a shell. If plugin commands are unavailable, update the CLI before continuing. To refresh the marketplace later, run codex plugin marketplace upgrade stewdio and follow update or reload prompts. Reference: Codex plugin commands.

​
Other agents and MCP clients

For Cursor, VS Code, Gemini CLI, or another host, consult its current official plugin guide or installed CLI’s --help. Use its supported installation path; configuration and authentication differ by host. If it supports only MCP servers, offer a plugin-capable client above. If the user chooses tools only, connect https://mcp.stewdio.ai/mcp with Streamable HTTP and OAuth, preserve existing settings, and verify authenticated tool access. Report this as an MCP connection, not a plugin installation; it lacks the bundled skill. Embedded File libraries, editors, and node previews require host support for MCP Apps. Otherwise, use tools to work with Files and open the returned Stewdio File links.

​
Start a new session

Make the new session one click away. Give the user a clickable link or button that opens a new session with this starter prompt filled in, where <Stewdio> is the host’s own reference to the installed plugin:
Use <Stewdio> to create a 10 second animation
Use the matching host’s prompt and link below. Render the link as a clickable Markdown link or button, and also show the prompt so the user can paste it if the link does not open. If the host’s chat renders custom-scheme links as plain text, show the link in a code block for the user to paste into the browser address bar. Links only fill in the prompt; the user reviews and sends it. If the installed plugin, skill, or marketplace name differs from stewdio, substitute it and URL-encode the prompt again. Claude desktop. Prompt: Use /stewdio to create a 10 second animation. Link: Start with Stewdio. For Claude Code in the desktop app, use the Claude Code CLI prompt with this link. Claude web. There is no prefill link. Link to a new chat, show the Claude desktop prompt, and tell the user to choose stewdio from the / menu if the typed reference is not recognized. Claude Code CLI. Prompt: Use /stewdio:stewdio to create a 10 second animation. Link (v2.1.91 or later): Start with Stewdio. It opens a new terminal window. Offer to open it for the user with open on macOS, xdg-open on Linux, or Start-Process on Windows. Without a desktop session, such as over SSH, give the command instead; it sends the prompt right away:
Codex CLI and Codex app. Prompt: Use [@Stewdio](plugin://stewdio@stewdio) to create a 10 second animation. Codex reads this link form as a plugin mention. Replace stewdio@stewdio with the plugin ID that codex plugin list reports if it differs. In the Codex app, link to Start with Stewdio. In the CLI, give the command; it sends the prompt right away:
Cursor. Prompt: Use /stewdio to create a 10 second animation. Link: Start with Stewdio. The equivalent cursor://anysphere.cursor-deeplink/prompt?text=… link opens Cursor directly. Admins can disable deeplinks. ChatGPT web and desktop. There is no prefill link. Link to a new chat, show Use @Stewdio to create a 10 second animation, and tell the user to type @ and choose Stewdio so the mention attaches to the plugin.

​
Verify the installation

  1. Confirm the plugin is installed and enabled and its bundled stewdio skill is available.
  2. Discover its tools and call the read-only list_files tool. A successful response confirms authenticated access, including when files is empty. Configuration, a server listing, an open sign-in page, or a tool list alone does not prove authenticated access.
  3. In MCP Apps hosts, call open_stewdio with {} and confirm that the File library opens. If embedded views are unavailable, report that limit separately from authenticated tool access. Do not create a test File to verify the connection.
If the skill or tools are missing, enable the plugin in the conversation or reload the client. For authentication errors, complete or repeat OAuth. If a new session is needed, state what is installed and what remains unverified; do not report success yet. Once verified, say the plugin is ready and ask what the user wants to create. Create a Stewdio File only when requested.