Sora Video Generation

v1.0.0Data Science & MLstable

Integrates with OpenAI's Sora 2 API to generate, remix, and manage AI-generated videos from text prompts. Supports video creation, status monitoring, downloading, and remixing through natural language commands.

sora-mcp-servermcpai-integration
Share:
211
Stars
0
Downloads
0
Weekly
0/5

What is Sora Video Generation?

Sora Video Generation is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to integrates with openai's sora 2 api to generate, remix, and manage ai-generated videos from text prompts. supports video creation, status monitoring, downloading, and remixing through natural language...

Integrates with OpenAI's Sora 2 API to generate, remix, and manage AI-generated videos from text prompts. Supports video creation, status monitoring, downloading, and remixing through natural language commands.

This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Integrates with OpenAI's Sora 2 API to generate, remix, and

Use Cases

Generate videos from text prompts using OpenAI Sora.
Remix and edit AI-generated videos.
Doriandarko

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 15, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx sora-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Sora Video Generation

Sora MCP Server integrates OpenAI's Sora video generation API into any MCP-compatible AI client, enabling you to create, monitor, download, remix, and manage AI-generated videos using natural language commands. It exposes seven distinct tools covering the full video lifecycle — from submitting a text prompt to Sora and polling job status, through to saving completed videos locally or remixing existing ones with new prompts. Developers and content creators use this server to automate video workflows directly from their AI assistant without switching to a separate interface.

Prerequisites

  • Node.js 18+ and npm installed
  • An OpenAI API key with access to the Sora API (OPENAI_API_KEY)
  • An MCP-compatible client such as Claude Desktop
  • Sufficient OpenAI API credits for video generation (Sora jobs are compute-intensive)
1

Clone the repository and install dependencies

Clone the sora-mcp repository and install Node.js dependencies.

git clone https://github.com/Doriandarko/sora-mcp
cd sora-mcp
npm install
2

Build the server

Compile the TypeScript source to JavaScript. The build output will be placed in the dist directory.

npm run build
3

Set your OpenAI API key

Export your OpenAI API key as an environment variable. You can also optionally set a custom download directory for saved videos.

export OPENAI_API_KEY=sk-your-openai-api-key
export DOWNLOAD_DIR=/path/to/your/videos  # optional, defaults to ~/Downloads
4

Configure Claude Desktop

Add the Sora MCP server to your Claude Desktop configuration file. On macOS this is located at ~/Library/Application Support/Claude/claude_desktop_config.json.

{
  "mcpServers": {
    "sora": {
      "command": "node",
      "args": ["/absolute/path/to/sora-mcp/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "sk-your-openai-api-key",
        "DOWNLOAD_DIR": "/Users/yourname/Videos"
      }
    }
  }
}
5

Restart Claude Desktop and verify

Restart Claude Desktop to load the new MCP server configuration. You should see the Sora tools available when you start a new conversation.

Sora Video Generation Examples

Client configuration

Add this to claude_desktop_config.json. Replace the path with the absolute path to your cloned sora-mcp directory.

{
  "mcpServers": {
    "sora": {
      "command": "node",
      "args": ["/Users/yourname/sora-mcp/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "sk-your-openai-api-key",
        "DOWNLOAD_DIR": "/Users/yourname/Downloads/sora-videos"
      }
    }
  }
}

Prompts to try

These prompts demonstrate the seven tools the Sora MCP server exposes — creation, status checking, listing, downloading, saving, remixing, and deletion.

- "Generate a video of a calico cat playing a piano on stage, 10 seconds long at 1080p"
- "Check the status of video job video_abc123"
- "List all my video generation jobs"
- "Save video video_abc123 to my downloads folder"
- "Remix video video_abc123 with a new prompt: the same scene but at sunset"
- "Delete the video job video_abc123"

Troubleshooting Sora Video Generation

create-video returns an authorization error

Ensure your OPENAI_API_KEY is valid and your account has been granted access to the Sora API. Sora access may require a separate waitlist enrollment or higher-tier OpenAI subscription. Verify the key is set correctly in the env block of your MCP config.

save-video tool says the video is not ready

Sora video generation can take several minutes. Use the get-video-status tool first to check the job status. Only attempt to save or download the video once the status shows as completed.

Downloaded video file is not found locally

Check the DOWNLOAD_DIR environment variable. If not set, videos default to your ~/Downloads folder. The save-video tool downloads automatically; the download-video tool instead returns a curl command you must run manually to retrieve the file.

Frequently Asked Questions about Sora Video Generation

What is Sora Video Generation?

Sora Video Generation is a Model Context Protocol (MCP) server that integrates with openai's sora 2 api to generate, remix, and manage ai-generated videos from text prompts. supports video creation, status monitoring, downloading, and remixing through natural language commands. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Sora Video Generation?

Follow the installation instructions on the Sora Video Generation GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Sora Video Generation?

Sora Video Generation works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Sora Video Generation free to use?

Yes, Sora Video Generation is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Data Science & ML MCP Servers

Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "sora-mcp-server": { "command": "npx", "args": ["-y", "sora-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Sora Video Generation?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides