Skip to main content
No official Descript connector for your AI assistant? As long as it supports MCP, point it at the Descript MCP server URL. Once linked, import media, edit with Underlord, manage projects, and publish from a conversation. For a full overview of what the Descript MCP can do, see Descript MCP overview. Official connectors are available for Claude and ChatGPT. To build an automated workflow instead, use Zapier or the Descript API.
Imports and Underlord edits through MCP use your media minutes and AI credits. See Track and understand your media minutes and AI credits.

​
Before getting started

The Descript MCP works with any AI assistant that supports custom MCP server connections. Before setting up, confirm your AI assistant meets these requirements:
  • Supports custom MCP connections via URL. Your AI assistant must let you add a remote MCP server by entering a URL. If your assistant only supports a fixed list of integrations, the Descript MCP won’t work there.
  • Supports OAuth authentication. The Descript MCP uses OAuth to authenticate. No API token is required. Your assistant needs to support OAuth-based MCP connections.
  • Network egress enabled (Claude only). Claude disables outbound network access by default. Go to Settings → Capabilities and turn on network egress and code execution before connecting. If you don’t have access to these settings, ask your Claude admin to enable them.
  • Admin access (for enterprise workspaces). If you’re using a team or enterprise plan on your AI assistant, your workspace admin may need to enable custom MCP connectors before you can add Descript.
Use Chat mode where availableIf your AI assistant offers multiple modes (like Chat vs. agent or autonomous modes), Chat mode generally produces the best experience with the Descript MCP.

​
Connect Descript as a custom MCP

​
What you’ll need

To connect Descript to any AI assistant, you’ll need:
  • The Descript MCP server URL: https://api.descript.com/v2/mcp
  • Authentication method: OAuth
  • A Descript account with access to the Drive you want to connect
This URL is the same for every account. Your login during OAuth is what ties the connection to you and to the Drive you’re signed into in the browser. The exact steps vary by AI assistant, but the general flow is the same. Most assistants have a settings area for adding custom MCPs, connectors, or tools.

​
General setup steps

  1. Find the custom connector setting in your AI assistant. This is usually under Settings, Integrations, Connectors, Apps, or Tools. Look for an option like “Add custom connector,” “Create app,” “Add MCP server,” or similar.
  2. Enter the Descript MCP details:
    • Name: Descript (or any name you prefer)
    • MCP server URL: https://api.descript.com/v2/mcp
    • Authentication: OAuth
  3. Save or create the connector. Your AI assistant may show a security warning about custom MCP servers. That’s standard for any third-party connector.
  4. Sign in to Descript when prompted. A browser page will open asking you to sign in and grant the AI assistant access. The MCP connects to whichever Descript Drive you’re currently logged into.
  5. Click Allow to grant access. You’ll be redirected back to your AI assistant. Descript should now appear in your list of connected tools or connectors.
To test the connection, try a prompt like: “Create a new Descript project about settling the question: since tomatoes are fruits, is tomato soup a smoothie?”
Can’t find a custom connector option?If your AI assistant doesn’t have an option to add a custom connector, it likely doesn’t support custom MCPs. Reach out to your AI assistant’s support team to confirm, or check their documentation for MCP support.

​
Tips for getting the best results

The MCP is scoped to a single Drive. You can only create and access projects on the Drive you chose when connecting. To switch Drives, log out of Descript on the web, then reconnect the MCP. Be specific in your prompts. Tell your AI assistant the project name, folder, composition, and what you want done. The more context you give, the better the result. Your AI assistant can pull in context from other tools. If you have other connectors set up (Google Drive, Slack, Notion, and similar), your assistant can use content from those tools to give Underlord richer instructions. For example: “Find the brief in my Google Drive called ‘Q3 Campaign’ and create a Descript video based on it.” Example prompts:
  • “Import this video from my desktop into my ‘Podcasts’ folder and transcribe it”
  • “Add Studio Sound and remove filler words from the second composition”
  • “Find my ‘Q2 Review’ project and create a 60-second highlight reel”
  • “Write a script about how to make great coffee, turn it into a video, and publish it”

​
Known limitations by AI environment

The Descript MCP follows the standard Model Context Protocol, but each AI assistant implements MCP support a little differently. Some tool calls may behave inconsistently or not work at all depending on the environment. This section tracks known issues. We’ll update it as new ones are reported or resolved.
  • No rendered file download without publishing. You can publish projects to Descript web links and get signed URLs to the MP4, but exporting a finished video or audio file without publishing is not supported. Export video in Descript or export audio. Transcript export is available through MCP.
  • YouTube URLs are not supported as import sources.
  • Job history is available for 30 days. After that, job records are no longer accessible.
  • Single-Drive scope. Editing a project on a different Drive than your connection is scoped to will return an error.

Related topics

Descript MCP overviewDescript APIConnect Descript to ChatGPTConnect Descript to ClaudeApp settings