Oh My Cassette

What Cassette-Editor/oh-my-cassette does

Cassette-Editor/oh-my-cassette is an AI video-editing plugin and local MCP server for creating montage videos through Cassette. An agent can work from a folder of raw clips, interpret a conversational editing request, select and arrange shots, plan pacing, synchronize cuts to music, and render after approval. The documented workflow is intended for users who want to control editing through chat rather than open a conventional timeline editor.

The server keeps the editing process organized around a session. Media is ingested into an isolated session, assets are exposed through a manifest, and the current project can be inspected as a bounded timeline digest with an optional contact sheet.

How it works

The workflow starts by adding trusted project media with cassette_ingest_media. The agent can then inspect the available assets and send the user's editing request as a conversational turn with cassette_run_job. A job may pause or detach, in which case cassette_job_status can resume it; guided questions can be answered through cassette_answer_question.

Before rendering, the agent can read the live timeline and review the proposed completion. cassette_review_completion provides an explicit approval step, while the run operation can render when export=true. This separates planning and inspection from final export. Cooperative cancellation is available through cassette_cancel_job.

Setup and configuration

The documented installation paths target Claude Code and Codex. Claude Code uses its marketplace and plugin-install commands for the Cassette-Editor/oh-my-cassette repository. Codex uses the repository URL to add the marketplace and then installs the plugin. The README also identifies Hermes Agent and OpenCode as supported hosts and refers other MCP hosts to its Quick Start instructions.

The project requires Python 3.11 through 3.13, ffmpeg, and a Cassette account. The server includes cassette_login for verifying and privately storing credentials, or for requesting a new password by email. Jamendo music matching has a separate setup tool, cassette_jamendo_setup, which verifies and privately stores the machine's Jamendo Client ID.

Tools and capabilities

The exposed tools cover these operations:

• Ingest trusted media and list the session's asset manifest.
• Run conversational editing turns, resume detached jobs, answer questions, cancel work, and inspect completion.
• Read a bounded timeline digest and optionally generate a contact sheet.
• Match free-to-use background music, an exact title and artist, or structured Jamendo preferences.
• Read or change the session's model and thinking level for later turns.
• Perform a manual command-lane edit or undo through cassette_edit when CASSETTE_DIRECT_EDIT=1 is enabled.
• Build an edit brief with cassette_make_prompt; the README marks this tool as legacy and superseded by verbatim relay.

The Cassette-Editor/oh-my-cassette MCP server therefore fits workflows that need conversational planning, media inspection, music selection, approval, and optional export in one agent-accessible session.

Limitations and notes

Rendering is not automatic at every step: the documented flow returns a timeline digest and contact sheet for review, and export is tied to an explicit approval flow. The server is designed around Cassette and requires a Cassette account. Music-related features may require separate Jamendo Client ID setup, depending on the matching workflow.

The material does not document support for general-purpose MCP clients beyond the named Claude Code, Codex, Hermes Agent, and OpenCode hosts. It also does not provide a license name in the supplied information. cassette_make_prompt should not be treated as the primary current workflow because it is identified as a legacy tool.

Getting started with this Cassette-Editor/oh-my-cassette MCP server

Always refer to the official documentation for the most accurate and up-to-date information.