Descript MCP server
Commit Nov 7, 2026Edit video and audio using natural language by connecting AI agents to your Descript projects and media.
Also known as descriptinc/descript-mcp, descript-mcp
- Stars
- 38
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 7, 2026
- License
- Apache-2.0
What is Descript MCP?
Descript edits video and audio using natural language by connecting AI agents to your Descript projects and media.
Summary generated from the project's README
About Descript MCP server
Editing video and audio through natural language commands is what this MCP server enables for creators and developers. By connecting AI agents to Descript projects, users can manage media assets and perform complex editing tasks without manual software manipulation. The server provides tools to search through a connected Drive, import media via URLs or direct uploads, and manage asynchronous jobs using wait and list commands.
Users interact with the server through various clients like Cursor, Claude Code, or Antigravity. Setup requires a Descript account and uses OAuth for authentication rather than static API tokens. Once connected, an agent can use the prompt_project_agent tool to perform edits like trimming clips, adding captions, or removing filler words. It also supports exporting transcripts and timelines for professional software like Premiere Pro or DaVinci Resolve, as well as publishing compositions as shareable links.
What you can do with it
- 1Natural language video editingAsk an AI agent to trim a video or add captions to a project using text commands.
- 2Automated media importingHave an agent create a new project by importing media files or URLs directly.
- 3Project and asset discoverySearch through your connected Drive to find specific projects, folders, or media files.
Written from the project's README. Every use case is checked against a quote from it.
How to install Descript MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Descript MCP in Claude Code
$ claude mcp add --transport http descript-mcp https://api.descript.com/v2/mcpInstall Descript MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"descript-mcp": {
"url": "https://api.descript.com/v2/mcp"
}
}
}Install Descript MCP in VS Code
.vscode/mcp.json
{
"servers": {
"descript-mcp": {
"type": "http",
"url": "https://api.descript.com/v2/mcp"
}
}
}Install Descript MCP in VS Code CLI
$ code --add-mcp '{"name":"descript-mcp","type":"http","url":"https://api.descript.com/v2/mcp"}'Install Descript MCP in Codex
$ codex mcp add descript-mcp --url https://api.descript.com/v2/mcpInstall Descript MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.descript-mcp] url = "https://api.descript.com/v2/mcp"
Install Descript MCP in Gemini CLI
$ gemini mcp add -s user --transport http descript-mcp https://api.descript.com/v2/mcpInstall Descript MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"descript-mcp": {
"url": "https://api.descript.com/v2/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabledescriptinc/descript-mcp is public and reachablegithub.com/descriptinc/descript-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-07github.com/descriptinc/descript-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubDescript MCP
Edit video and audio by editing text. Import media, create projects, and use AI to edit — all from your agent.
What's included
MCP Server
Connects to the Descript API over MCP, giving agents access to:
- Discover —
search_drivefinds projects, folders, media, layout packs, and transcript matches across the connected Drive;list_projects/get_projectinspect projects and their compositions, media, and metadata;list_folders/get_drive_infobrowse folders and inspect a Drive - Import —
import_media(via URL or direct file upload),import_drive_media(from a connected Google Drive),file_upload_ui(direct file uploads) - Edit —
prompt_project_agentedits with Underlord, our AI co-editor, using natural language (trim, add captions, remove filler words, and so much more) - Publish —
publish_projectpublishes a composition as a shareable link and exported video or audio - Export —
export_transcriptexports a project's transcript;export_timelineexports a Premiere Pro / DaVinci Resolve timeline - Jobs —
wait_for_job/list_jobs/cancel_jobtrack and manage async jobs;report_upload_statusreports direct-upload progress
Full tool reference and auth details: Descript MCP docs.
Rules / context
Bundles a descript-workflows rule with best practices for working with the Descript tools: find items with search_drive (or paginate projects with list_projects) before editing, inspect with get_project, pass media URLs to import_media as-is, use prompt_project_agent for natural-language edits, and always follow the async tools (import_media, prompt_project_agent, publish_project) with wait_for_job.
The rule is Cursor-format (rules/descript-workflows.mdc). Antigravity reads the same guidance from AGENTS.md at the repo root. Claude Code has no rules concept, so it relies on the bundled skills for the same workflows.
Skills
- create-video — Create a new project from media files or URLs
- edit-project — Edit an existing project using AI-powered natural language
- publish-project — Publish a composition to create a shareable link and exported video or audio file
- export-transcript — Export a project's transcript as a downloadable file
- export-timeline — Export a project's timeline for Premiere Pro or DaVinci Resolve
Setup
The Descript MCP authenticates with OAuth — no API token. On first connection you sign in to Descript and pick the Drive the agent can access. To switch Drives later, log out of Descript on the web and reconnect.
Install from an official marketplace listing only: let it register the server, sign in with OAuth, pick a Drive, then confirm the connection with get_drive_info. Don't also add a second, custom Descript MCP server by hand — a duplicate connection means conflicting sessions.
Every MCP client points at the same remote server:
https://api.descript.com/v2/mcp
Quick-install steps differ by harness.
Cursor
This repo is a Cursor plugin, so installing it brings the MCP server, the descript-workflows rule, and the skills together.
- Add this plugin to Cursor (from the plugin marketplace, or by pointing Cursor at this repository).
- Cursor registers the
descriptMCP server, rule, and skills. - When the server first connects, sign in to Descript and choose a Drive.
One-click alternative: open Settings → Descript MCP in the Descript app and use the Cursor connect button, or install the MCP server with a deep link:
cursor://anysphere.cursor-deeplink/mcp/install?name=Descript&config=eyJ1cmwiOiJodHRwczovL2FwaS5kZXNjcmlwdC5jb20vdjIvbWNwIn0=
The deep link installs only the MCP server; the rule and skills come from the plugin.
Claude Code
This repo is also a Claude Code plugin, so installing it brings the MCP server and the skills together. Add the repo as a marketplace, then install the plugin:
/plugin marketplace add descriptinc/descript-mcp
/plugin install descript@descript
Claude Code registers the descript MCP server and auto-discovers the skills. When the server first connects, sign in to Descript and choose a Drive.
If you only want the server without the skills, add it on its own:
claude mcp add --transport http descript https://api.descript.com/v2/mcp
The descript-workflows rule is Cursor-format and does not load in Claude Code; the same guidance is carried by the bundled skills.
Antigravity
Google's Antigravity reads project context straight from this repo — no install step. Open the repo as your Antigravity workspace and it picks up the AGENTS.md workflow guidance at the root. Antigravity also reads the same SKILL.md format as Claude Code, so the bundled skills apply there too.
The MCP server is added separately, in Antigravity's own config. Antigravity does not reliably load an MCP server from a repo-committed file — project-local mcpServers are currently discovered but ignored, so the server has to live in the user-level config, added through the UI:
-
In the Agent panel, open the
...(Additional Options) menu → MCP Servers → Manage MCP Servers → View raw config. -
Add the
descriptserver undermcpServers. Antigravity uses theserverUrlkey for remote HTTP servers (noturl):{ "mcpServers": { "descript": { "serverUrl": "https://api.descript.com/v2/mcp" } } } -
Save, then reconnect. When the server first connects, sign in to Descript and choose a Drive.
The raw config file lives under your home directory (~/.gemini/config/mcp_config.json on recent builds; older builds used ~/.gemini/antigravity/mcp_config.json) — using View raw config avoids depending on the exact path.
Codex
This repo is a Codex plugin marketplace (.agents/plugins/marketplace.json) whose single plugin, descript, is the repo root. Installing it brings the descript MCP server (from mcp.json) and the skills together.
From GitHub, add the marketplace, then install the plugin:
codex plugin marketplace add descriptinc/descript-mcp --ref main
codex plugin add descript@descript
From a local checkout, add the marketplace by its absolute path, then install the same way:
codex plugin marketplace add /absolute/path/to/checkout
codex plugin add descript@descript
To update a GitHub-sourced install, refresh the marketplace's Git snapshot:
codex plugin marketplace upgrade descript
Running git pull in a local checkout changes the files on disk but does not by itself refresh the plugin copy Codex has installed; reinstall the plugin after updating the checkout.
The plugin authenticates on install: sign in to Descript and choose the Drive the agent can access. To switch Drives later, log out of Descript on the web and reconnect.
If you only want the tools without the skills, add just the bare MCP server pointed at https://api.descript.com/v2/mcp with OAuth. Install the complete plugin or add the bare server — not both. A second, hand-added Descript server alongside the plugin's means two connections and conflicting sessions.
Other MCP clients
Any other MCP client works by adding the remote server on its own — a remote (HTTP) server pointed at https://api.descript.com/v2/mcp with OAuth. See Connect Descript to any AI assistant for the general flow. The descript-workflows rule and the skills in this repo are harness-specific bundle content and don't travel with a bare MCP connection.
Claude and ChatGPT
Descript ships official connectors in both directories — no server URL needed:
- Claude — add Descript from the Anthropic connector directory. See Connect Descript to Claude.
- ChatGPT — add the Descript app from the ChatGPT app marketplace. See Connect Descript to ChatGPT.
Official sources
Only the published server endpoint (https://api.descript.com/v2/mcp) and Descript's official marketplace listings — the ChatGPT app, the Claude connector, and the Cursor plugin linked above — are official. Any other listing, connector, or fork is not affiliated with or endorsed by Descript.
Requirements
- A Descript account
- An agent harness with MCP support
Development
npm install
npm run check # lint, format check, and plugin validation
npm run fmt # apply formatting
CI runs the same checks on every pull request. npm run validate covers the Cursor manifest, the portable / OpenAI manifest and skill dependencies, and MCP endpoint consistency; npm test runs the validator's regression tests; npm run check runs lint, format checks, tests, and validation.
Maintainers: see RELEASE.md for how the OpenAI (ChatGPT) listing is refreshed from this repo and how direct installs ship, including the package-identity rules.
This repository is source-available under the included license. We are not currently accepting external code contributions or pull requests.
License and legal
Licensed under the Apache License 2.0.
Descript's names, logos, and brand features are trademarks — see TRADEMARKS.md for what you may and may not do with them.
Use of the hosted Descript MCP server and API is subject to Descript's Terms of Service.
Descript MCP questions
How do I add Descript MCP to Claude Code?
Run claude mcp add --transport http descript-mcp https://api.descript.com/v2/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Descript MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does Descript MCP authenticate?
The server uses OAuth for authentication. On your first connection, you will sign in to Descript and select the Drive you want the agent to access.
Can I edit projects using natural language?
Yes, you can use the prompt_project_agent tool to perform edits like trimming, adding captions, or removing filler words using natural language via the AI co-editor, Underlord.
How do I manage long-running tasks like imports or publishing?
You should use the provided async tools such as wait_for_job, list_jobs, or cancel_job to track and manage these processes.