---
title: "Add Epidemic Sound music to HyperFrames | Shorts Origin"
description: "Connect the Epidemic Sound MCP server to Claude Code, have it fetch and trim a licensed track, and put it in a HyperFrames Short. The commands from both docs."
url: https://www.shortsorigin.com/guides/add-epidemic-sound-music-to-hyperframes
---

# Add Epidemic Sound music to HyperFrames

![Two monitors on a dark desk, one full of code, with a pair of over-ear headphones and a keyboard in front of them](https://www.shortsorigin.com/images/guides/add-epidemic-sound-music-to-hyperframes.webp)

Photo by Farzad Nazifi on [Wikimedia Commons](https://commons.wikimedia.org/wiki/File:Coding%5Fworkstation%5F%28Unsplash%29.jpg), released under [CC0](https://creativecommons.org/publicdomain/zero/1.0/).

Add Epidemic Sound's MCP server to Claude Code with an API key, ask it to find and cut a track to your Short's length, and save the file in your HyperFrames project. Downloading needs a paid Epidemic plan.

HyperFrames can put music under a Short, but it does not license any. Its FAQ says "media you add, such as fonts, music, or footage, keeps its own license." Without a HeyGen account, its voice and audio page lists the free music option as "tracks you add". This page covers one way to add them: let Claude Code fetch a track from Epidemic Sound through Epidemic's MCP server, cut to the length of your Short, straight into the project folder.

It assumes HyperFrames is already installed in Claude Code. If not, start with [How to make YouTube Shorts with Claude Code](https://www.shortsorigin.com/guides/how-to-make-youtube-shorts-with-claude-code). Every step below comes from Epidemic Sound's developer docs and HyperFrames' docs, read on 18 November 2026\. Nobody ran them for this page, so treat them as what the docs say, not as a tested recipe.

## What you need

- **A paid Epidemic Sound plan, to download.** Epidemic Sound's docs say "a free account can search and preview. Downloading needs an active paid subscription." ([See the plans](https://www.shortsorigin.com/go/epidemic-sound), affiliate link.)
- **An MCP Server API key.** Claude Code "doesn't support OAuth to the MCP Server yet", so it connects with a key instead of a sign-in. Create one in your Epidemic Sound account under **Account**, then **API keys**. The docs say a key is valid for one year, and that a key from the Developer Portal does not work here.
- **HyperFrames in Claude Code**, with Node.js 22 or newer and FFmpeg.

## Connect Epidemic Sound to Claude Code

These commands are from Epidemic Sound's Claude Code section. First put the key in an environment variable:

```
export EPIDEMIC_SOUND_MCP_API_KEY="your_mcp_server_api_key_here"
```

Then register the server:

```
claude mcp add -s user --transport http epidemic-sound https://www.epidemicsound.com/a/mcp-service/mcp \
  --header 'Authorization: Bearer ${EPIDEMIC_SOUND_MCP_API_KEY}'
```

Keep the single quotes. The docs explain that they stop your shell from filling in the key, so Claude Code expands it when it reads its settings and the key is never written to the file. Check the connection with:

```
claude mcp list
```

`epidemic-sound` should report **Connected**. If it fails, the docs' first check is that the variable is exported and not empty in the terminal you started Claude Code from. To keep it across sessions, add the `export` line to your shell profile, such as `~/.zshrc`.

## Ask for the track

Open Claude Code in your HyperFrames project folder and describe the music. Epidemic Sound's server has tools to search by genre, mood, BPM and key, to find tracks like an artist or song you name, and to cut a track to a set length.

The cut is what makes this worth doing for a Short. Epidemic's docs describe the steps: pick a track, ask for a target length of up to 5 minutes, and optionally pin a section, such as the chorus, to land at an exact second. A request like this covers it:

```
Find an upbeat lo-fi track around 90 BPM on Epidemic Sound, cut it to 45 seconds with the chorus starting at second 8, download it into this project, and use it as the background music in the HyperFrames composition.
```

Use an API key connection for this. Epidemic's docs say the tool that returns an edit's ID "may not be available on all connections", and without it the edit can't be downloaded. An edit also comes back as one finished mix: for separate stems, download the original track instead. The docs don't say what file format a download is, so check the name of the file Claude Code saves and use that in the composition.

HyperFrames' media page asks for exactly this: "Put anything required for the final result inside the project so preview and rendering use the same file." In the composition, a music track is an `<audio>` element with a start time, a length, a track number and a volume. The README's example:

```
<audio
  data-start="0"
  data-duration="6"
  data-track-index="2"
  data-volume="0.5"
  src="music.wav"
></audio>
```

If the track is shorter than the Short, HyperFrames' audio page says the standard `loop` attribute repeats it until the slot ends.

## Get the mix right

HyperFrames' prompting page warns against a bare "add background music", which it says gets "a full-volume track fighting the VO". It suggests naming the level instead, for example "subtle background music, ducked \~12 dB under the voice". For music that sits under narration, the same page recommends a "carve", which takes only the few bands the voice occupies out of the music rather than turning the whole track down.

The audio page's checklist for the finished mix: the voice stays clear through the loudest part of the music, each sound effect lands with the thing it belongs to, and "the music ends on purpose, not at the end of the file."

## Before you publish

Epidemic Sound's docs say its music and sound effects "are licensed through your Epidemic Sound subscription", and the MCP server's own licence covers only the software. So the rules for a track fetched this way are the same as for one downloaded from the website, and that includes safelisting. Epidemic Sound's help centre says safelisting needs an active subscription, that you add the channel in the Safelisting section of your Epidemic Sound account, and that a Creator plan covers one channel per platform. Do it before the Short goes live. How Epidemic Sound clears Content ID claims on your channel, and what happens to your Shorts if you cancel, is on the [Epidemic Sound page](https://www.shortsorigin.com/music/epidemic-sound). The [Epidemic Sound MCP guide](https://www.shortsorigin.com/guides/how-to-use-the-epidemic-sound-mcp-server) covers the server's other tools and the no-code setup in Claude and ChatGPT.

Fair warning: Epidemic Sound marks its MCP server as beta, and HyperFrames' own music option, when you sign in with a HeyGen account, is a separate 10,000-track HeyGen catalogue. Neither the HyperFrames docs nor HeyGen's terms of service say whether that catalogue is cleared for monetised YouTube videos. If you want Epidemic music, name Epidemic Sound in the request.

One subscription licensed for YouTube, Instagram and TikTok. Safelist your channel and YouTube claims clear automatically, and videos published while you subscribe stay cleared after you cancel. Creator is $8.99 a month after 30 days free.

[How Epidemic Sound clears claims, and the catch](https://www.shortsorigin.com/music/epidemic-sound)

[Start the 30-day free trial](https://www.shortsorigin.com/go/epidemic-sound)

Affiliate link. If you subscribe through it, Shorts Origin gets a subscription credit from Epidemic Sound. It does not change where Epidemic Sound sits on this site, which comes from what its own licence and help pages say.

## Common questions

### Can I use the Epidemic Sound connector from Claude.ai in Claude Code?

Epidemic Sound's docs say a directory connector added in Claude.ai also appears in Claude Code, without the voiceover tools. For the full set of tools, add the server URL directly with an API key.

### Does a free Epidemic Sound account work?

For searching and previewing, yes. Epidemic Sound's docs say downloading needs an active paid subscription.

### Does HyperFrames license the music for me?

No. The HyperFrames FAQ says media you add keeps its own licence. Epidemic Sound says its music is licensed through your Epidemic Sound subscription.

### How long can a trimmed track be?

Up to 5 minutes. Epidemic Sound's docs cap a track edit at 300,000 milliseconds, which is far more than a Short needs.

## Sources

1. [MCP Server (Beta), Epidemic Sound developer docs](https://developers.epidemicsound.com/docs/mcp/) developers.epidemicsound.com
2. [Add voiceover, music, sound effects and captions (HyperFrames docs)](https://hyperframes.heygen.com/guides/voice-and-audio) hyperframes.heygen.com
3. [Add voice, music and sound (HyperFrames docs)](https://hyperframes.heygen.com/prompting/media-and-audio) hyperframes.heygen.com
4. [Work with media (HyperFrames docs)](https://hyperframes.heygen.com/guides/media) hyperframes.heygen.com
5. [Make videos with Claude Code (HyperFrames docs)](https://hyperframes.heygen.com/guides/with-claude-code) hyperframes.heygen.com
6. [HyperFrames FAQ](https://hyperframes.heygen.com/faq) hyperframes.heygen.com
7. [HyperFrames README (GitHub)](https://github.com/heygen-com/hyperframes) github.com
8. [Safelist channels (Epidemic Sound Help)](https://www.epidemicsoundhelp.com/hc/en-us/articles/25890103714706-Safelist-channels) epidemicsoundhelp.com
9. [HeyGen terms of service](https://www.heygen.com/terms) heygen.com

Facts checked against the sources below on 18 Nov 2026. Licences and prices change, so read the provider's own page before you rely on one.

## More guides

- [How to make YouTube Shorts with Claude Code](https://www.shortsorigin.com/guides/how-to-make-youtube-shorts-with-claude-code)
- [HyperFrames vs Remotion for YouTube Shorts](https://www.shortsorigin.com/guides/hyperframes-vs-remotion-for-youtube-shorts)
- [Do old YouTube videos keep earning money](https://www.shortsorigin.com/guides/do-old-youtube-videos-keep-earning-money)
- [Why is my YouTube RPM so low](https://www.shortsorigin.com/guides/why-is-my-youtube-rpm-so-low)
- [How to fix a YouTube tagging violation](https://www.shortsorigin.com/guides/how-to-fix-a-youtube-tagging-violation)
- [How to add captions to YouTube Shorts](https://www.shortsorigin.com/guides/how-to-add-captions-to-youtube-shorts)

[See every guide](https://www.shortsorigin.com/guides#making-with-ai)
