descript-mcp

# Descript 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](https://www.descript.com/api) over MCP, giving agents access to: - **Discover** — `search_drive` finds projects, folders, media, layout packs, and transcript matches across the connected Drive; `list_projects` / `get_project` inspect projects and their compositions, media, and metadata; `list_folders` / `get_drive_info` browse 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_agent` edits with Underlord, our AI co-editor, using natural language (trim, add captions, remove filler words, and so much more) - **Publish** — `publish_project` publishes a composition as a shareable link and exported video or audio - **Export** — `export_transcript` exports a project's transcript; `export_timeline` exports a Premiere Pro / DaVinci Resolve timeline - **Jobs** — `wait_for_job` / `list_jobs` / `cancel_job` track and manage async jobs; `report_upload_status` reports direct-upload progress Full tool reference and auth details: [Descript MCP docs](https://www.descript.com/mcp). ### 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](https://help.descript.com/descript-tour/drive-view) 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. 1. Add this plugin to Cursor (from the plugin marketplace, or by pointing Cursor at this repository). 2. Cursor registers the `descript` MCP server, rule, and skills. 3. 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](https://antigravity.google) 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: 1. In the Agent panel, open the `...` (Additional Options) menu → **MCP Servers** → **Manage MCP Servers** → **View raw config**. 2. Add the `descript` server under `mcpServers`. Antigravity uses the `serverUrl` key for remote HTTP servers (not `url`): ```json { "mcpServers": { "descript": { "serverUrl": "https://api.descript.com/v2/mcp" } } } ``` 3. 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](https://help.descript.com/descript-tour/drive-view) 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](https://help.descript.com/api-and-mcp/mcp-custom) 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](https://claude.ai/directory/connectors/descript). See [Connect Descript to Claude](https://help.descript.com/api-and-mcp/mcp-claude). - **ChatGPT** — add the Descript app from the [ChatGPT app marketplace](https://chatgpt.com/apps/descript/asdk_app_69f0dc45f6048191876c14c1016fe778). See [Connect Descript to ChatGPT](https://help.descript.com/api-and-mcp/mcp-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](https://www.descript.com) 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](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](LICENSE). Descript's names, logos, and brand features are trademarks — see [TRADEMARKS.md](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](https://www.descript.com/terms).