Skip to main content
This is the simplest way to use the Descript API. Connect your AI assistant, then describe what you want in plain English. “Remove filler words and add captions.” “Create a highlight reel from my latest recording.” The assistant calls Descript on your behalf — no API token, no code, no curl. The MCP connector handles authentication through OAuth. You connect once, then it just works.

​
Claude

Connect Descript as a connector in the Claude app (claude.ai, web or desktop).
1

Open Connectors

In the left pane, navigate to Customize → Connectors, and click the + sign to add a custom connector.
2

Add Descript

Enter Descript as the name and https://api.descript.com/v2/mcp as the remote MCP server URL, then click Add.
3

Connect

Descript will appear under the “Not connected” list. Click Connect to log in.
4

Authorize

Sign into your Descript account in the browser window that opens and click Allow. You’ll be redirected back to Claude — you’re connected.
Once connected, type a prompt in any Claude conversation to start editing video.

​
Claude Code

Add the Descript MCP server from your terminal: 
claude mcp add descript --transport http https://api.descript.com/v2/mcp
Then authenticate by running /mcp inside Claude Code and completing the OAuth sign-in. Claude Code can then import media, run agent edits, and check job status directly from the command line.

​
Cursor

Add the MCP server in Cursor’s settings. The hosted MCP URL is: 
https://api.descript.com/v2/mcp
See Cursor’s MCP documentation for where to add this in your Cursor configuration.

​
Other MCP-compatible tools

Any tool that supports the Model Context Protocol can connect to Descript using the hosted URL: 
https://api.descript.com/v2/mcp
Check your tool’s documentation for how to add an MCP server.

​
Example prompts

Once connected, try these to get started: Import media:
  • “Create a Descript project from this video: [URL]”
  • “Import this video into a new project called ‘Weekly Update’”
Edit a project:
  • “Add Studio Sound and captions to my latest project”
  • “Remove all filler words from the project”
  • “Make a 30-second highlight reel from my project”
Create from scratch:
  • “Write a script about how to make great coffee and create a video from it”
Be specific. The API works best with clear, complete instructions in a single prompt. Instead of “make it better,” try “remove filler words, add Studio Sound, and generate captions.”

​
How conversation works

When you use Descript through Claude or another AI assistant, you can have a multi-turn conversation. Each message you send can trigger a separate API call — so “import this video,” followed by “now add captions,” works naturally. Under the hood, each API call is independent (the Agent API doesn’t carry context between calls). But your AI assistant manages that context for you, making the experience feel conversational.
For best results, be specific in each message. “Add Studio Sound, remove filler words, and generate captions” in one message is more reliable than splitting it across three.

​
Limitations

  • No local file upload: Media must be hosted at a public or pre-signed URL. You can’t upload files directly from your computer.
  • No export: After editing, open the project in Descript to export. There’s no export endpoint yet.