How to connect ChatGPT to Runway Dev

Summary

ChatGPT connects to your Runway Dev API account through the Runway Dev plugin, so you can ask about your models, prices, credits, Model Routers and failed tasks in a chat.

Install the plugin from ChatGPT’s plugin directory and sign in with your Runway Dev account, on the web, desktop or mobile.

To write the integration in your codebase, use Codex, which installs the same plugin.

This article covers installing the plugin, what to ask it and how it differs from the Runway app for ChatGPT.

This guide is for developers building with the Runway Dev API, where your own code triggers generation automatically, often at large scale. ChatGPT answers from your live account rather than from what it remembers about the platform.

Want to make one-off images or videos in ChatGPT instead? That takes Runway MCP, not the API. Install the Runway app for ChatGPT, sign in with your Runway account and describe what you want in the chat. It generates on your Runway plan, with no code and no developer mode. The Runway Help Center article Connecting to Runway MCP has the steps. The rest of this page does not apply to it.

ChatGPT or Codex: which one for what

ChatGPT Codex
Reads your Runway Dev account Yes Yes
Writes the integration in your codebase No Yes
Creates Model Routers and Characters Yes, with a confirmation Yes, with a confirmation
How it connects Runway Dev plugin, from the plugin directory Runway Dev plugin, from the CLI or the directory

Step 1: Install the Runway Dev plugin

Open Runway Dev in the plugin directory, or open the Plugins tab in ChatGPT and search for Runway Dev, then install it. ChatGPT and Codex share this directory, so it is the same plugin Codex installs.

The Runway Dev plugin bundles two parts:

  • The Runway Dev MCP, at https://dev.runwayml.com/mcp, which connects ChatGPT to your Runway Dev account: the projects on it, the models each one can call with their prices and input limits, your credit balance, your Model Routers, your Characters and the record behind any task.
  • Seven Runway Dev skills, which tell ChatGPT how Runway Dev’s models, Model Routers, Characters, Recipes and Workflows work.

When ChatGPT connects the Runway Dev MCP, during the install or the first time you use the plugin, it opens Runway Dev’s sign-in page at dev.runwayml.com/login. Sign in with your Runway Dev account and approve access. The connection is OAuth, so no API key goes into ChatGPT. Complete the sign-in yourself rather than asking an agent to automate it.

Step 2: Use it in a conversation

Start a new chat after installing, then ask about your account directly, or type @ and choose Runway Dev to call the plugin explicitly. Anything that would change your account surfaces a confirmation before it runs.

Confirm it worked. Ask which Runway Dev account it is connected to and how many credits you have. It should return the email on your Runway Dev account and your current balance.

Or add Runway Dev MCP as a custom connector

ChatGPT can also connect to the Runway Dev MCP alone, as a custom connector, which suits a workspace that manages its own connectors. Custom connectors sit behind developer mode, so turn it on first, in Settings. OpenAI documents the current path in developer mode and MCP apps in ChatGPT. Accept the warning that custom connectors run third-party code on your behalf.

Then add a new custom connector pointed at the Runway Dev MCP server:

https://dev.runwayml.com/mcp

Give it a name and a description, and choose OAuth as the authentication method. ChatGPT reads the description when deciding whether to reach for the connector, so write it rather than leaving it blank. In a new chat, open the composer menu and select the Runway Dev connector.

If you do not see the developer mode option, an admin may have to allow custom connectors on your workspace first, or your plan may not include them.

What to ask it

  • Which models can this project call, and what does each one cost?
  • How many credits do I have left?
  • What is this Model Router set to optimize for, and which models are eligible?
  • Why did my last generation fail?
  • Which model ran for that request, and why did the router pick it?

When the answer turns into work, hand it to Codex. It installs the same Runway Dev plugin and writes the integration in your codebase.

Install the Runway Dev plugin in ChatGPT and ask it what your project can call. Create an account to start building.

FAQ

Can I connect ChatGPT to Runway Dev?

Yes. Install the Runway Dev plugin from ChatGPT’s plugin directory and sign in with your Runway Dev account. ChatGPT can then answer from your live Runway Dev account: models, prices, credits, router configuration and failed tasks.

What is the difference between the Runway Dev plugin and the Runway app for ChatGPT?

The Runway Dev plugin connects ChatGPT to your Runway Dev API account, for developers building integrations. The Runway app for ChatGPT generates images and videos in the chat on your Runway plan, through Runway MCP.

What is the Runway Dev MCP server URL for ChatGPT?

https://dev.runwayml.com/mcp. The Runway Dev plugin connects to it for you, and it is the URL to use for a custom connector.

Can ChatGPT build a generative media integration for me?

No. ChatGPT runs in OpenAI’s cloud and does not work inside your codebase. Use Codex for building, which installs the same Runway Dev plugin and can write and update the integration in your project.

Why can’t I add a custom connector in ChatGPT?

Usually one of two reasons: custom connectors require developer mode, which is off by default, or you are on a managed workspace where an admin has to permit custom connectors first. Free ChatGPT does not support them.

Do I need a Runway API key to connect ChatGPT?

No. The Runway Dev plugin authenticates with OAuth in the browser, so no key goes into ChatGPT. You only need RUNWAYML_API_SECRET when your own application makes live generation calls.

What can I ask ChatGPT once Runway Dev is connected?

Which models your project can call and what they cost, your credit balance, what a Model Router is set to and which models are eligible, why a generation failed, and which model ran for a given request.

Is this the same as the Runway Media MCP?

No. Runway Dev MCP, at dev.runwayml.com/mcp, connects an agent to your Runway Dev account so it can plan, configure and debug an integration. Runway Media MCP, at mcp.runwayml.com, generates media inside a chat.

Can ChatGPT change my Runway Dev account?

It can create and manage configurations such as Model Routers and Characters, and anything that changes your account surfaces a confirmation before it runs. You complete the OAuth sign-in yourself.

Does Runway Dev MCP work with other coding agents?

Yes. Claude Code, Codex, Cursor and Grok Bot install the Runway Dev plugin, and any other client that supports remote MCP servers connects to the same URL. How to build a generative media integration with your coding agent has the steps for each.

Start building on Runway Dev