How to use the Epidemic Sound MCP server

Add Epidemic Sound as a connector in Claude or ChatGPT and sign in, then ask for music in plain words. A free account can search and preview. Downloading needs a paid Epidemic Sound subscription.
Epidemic Sound runs an MCP server, still marked beta. MCP (Model Context Protocol) is the standard AI assistants use to plug into outside services. Once you connect it, you can ask Claude or ChatGPT for "an upbeat lo-fi track around 90 BPM" and get real tracks from the Epidemic Sound catalogue back, then download them, without opening the Epidemic Sound site.
This page has two halves. The first needs no technical skill: you click through a settings screen and sign in. The second is for people who use Claude Code, Cursor or their own scripts, and connects with an API key.
What it can do
Epidemic Sound's developer docs list five groups of tools:
- Music search. Search by genre, mood, BPM, key and other filters, find tracks similar to one you like, or name a real artist or song and get catalogue tracks in that style.
- Sound effects. Search them, and find similar ones.
- Track adaptation (beta). Cut a track to a set length, up to 5 minutes, and pin a section (say, the chorus) to land at an exact second.
- Voiceovers. Generate a voiceover from your script with a stock voice or your own voice replica.
- Downloads. Download tracks and sound effects.
For Shorts, the cut-to-length tool is the interesting one. Cut a 3-minute track down by hand and it usually stops mid-phrase. Asking for "this track cut to 30 seconds, with the drop at second 8" is exactly what the tool is for, though it has limits on the no-code route (see the catch below).
What you need
An Epidemic Sound account. The docs say a free account can search and preview, and that downloading needs an active paid subscription. Epidemic Sound's help centre goes further and says the MCP server "requires an active Epidemic Sound subscription". Either way, plan on paying if you want files. Every plan starts with 30 days free, so you can try downloads before you pay (start the trial, affiliate link).
You do not need an Epidemic Sound developer account. The help centre says the free developer API tier does not give access to the MCP server, which is a separate product.
Three ways to connect
| Way | Works in | Setup | What is missing |
|---|---|---|---|
| Claude directory | Claude on the web, desktop and mobile, Claude Code, Cowork | Add Epidemic Sound from Claude's directory | The voiceover tools |
| Server address, sign in | Claude, ChatGPT, Cursor, Antigravity | Paste the server address and sign in | Downloading a trimmed track may not work |
| API key | Any MCP client that can send a key, including Claude Code | Create a key and add it to the client's settings | Nothing. Every tool works |
If you only want to find and download music, the first two are fine. If you want trimmed tracks, use the API key. Epidemic Sound's docs say so directly.
The no-code way
You need the Claude or ChatGPT app and your Epidemic Sound login. Nothing to install.
In Claude, from the directory
Open Epidemic Sound's listing in Claude's directory and add it. Epidemic Sound says a connector added this way in Claude on the web also shows up in Claude Code. It leaves out the voiceover tools, because Claude's directory does not allow them.
In Claude Desktop, with the server address
This route keeps the voiceover tools.
- Open Claude Desktop, then Settings, then Connectors.
- Click "Add custom connector".
- Name it Epidemic Sound and paste this address:
https://www.epidemicsound.com/a/mcp-service/mcp - Click "Add". Claude opens a browser window.
- Log in with your Epidemic Sound account and approve access.
In ChatGPT
- Open your ChatGPT plugins, click "Add" and choose "Add custom MCP Server".
- Name it Epidemic Sound and paste the same address into the "Connector" field:
https://www.epidemicsound.com/a/mcp-service/mcp - Log in with your Epidemic Sound account when asked.
What to ask it
Ask the way you would ask a music supervisor. Epidemic Sound says the assistant reads each tool's filters (genre, mood, BPM, key) and fills them in from your words, so a specific request gets better results than "some background music". A few that fit Shorts:
- "Find five energetic electronic tracks between 120 and 130 BPM for a 30-second cooking Short."
- "Find tracks that sound like Daft Punk." The docs describe this as a two-step search the assistant runs for you.
- "Find a whoosh sound effect and a short notification ping."
The technical way: an API key
Use this for Claude Code, which cannot sign in to the MCP server yet, and for anything you build yourself.
Create the key
Log in to Epidemic Sound and go to Account, then API keys. Create a key. It is tied to your account and lasts one year. To replace it, create a new one on the same page. Keep it in an environment variable, as Epidemic Sound recommends, not pasted into a settings file:
export EPIDEMIC_SOUND_MCP_API_KEY="your_mcp_server_api_key_here"
Add that line to your shell profile (for example ~/.zshrc) so it survives a restart.
Claude Code
Register the server once, for every project:
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. They stop your shell from filling in the key, so Claude Code reads it from the variable each time and the key never lands in ~/.claude.json. Then check it:
claude mcp list
epidemic-sound should say "Connected". If it says "Failed to connect", the variable is probably empty in the terminal you started Claude Code from. When the key expires, change the variable; the server entry stays as it is.
Cursor
In Cursor, go to Settings, then MCP, and click "New MCP server" to open mcp.json. Cursor can also sign in without a key (leave out headers, then click "Connect"), which Epidemic Sound recommends. With a key:
{
"mcpServers": {
"epidemic-sound": {
"url": "https://www.epidemicsound.com/a/mcp-service/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_SERVER_API_KEY"
}
}
}
}
Any other client or your own script
Any client that speaks MCP over Streamable HTTP and can send an Authorization header works. Send the key as a bearer token on every request to https://www.epidemicsound.com/a/mcp-service/mcp. Epidemic Sound points to the official MCP TypeScript SDK if you are writing your own client.
A 401 Unauthorized does not say why the key was refused. Epidemic Sound lists three things to check: the client sends the Authorization header, the key came from Account, then API keys (not the Developer Portal), and it is less than a year old.
The catch
Downloading a trimmed track may fail when you signed in instead of using a key. Epidemic Sound says the tool that reports a finished edit "may not be available on all connections", and without it the download step cannot find the file. Use an API key for trimmed tracks.
Some other limits Epidemic Sound lists:
- The server is in beta, and Epidemic Sound does not publish its rate limits.
- A trimmed track is one full mix, capped at 5 minutes. For separate stems, download the original track instead.
- Never put the API key in a web page. Epidemic Sound says browser JavaScript cannot call the server, and anyone who opens the page could read the key. A key belongs on your own machine or your own server.
- The key is yours alone. If you build a tool for other people, each of them creates their own key from their own account; Epidemic Sound says you must not share yours.
Is the music licensed and safelisted?
Epidemic Sound says music and sound effects you get through the MCP server "are licensed through your Epidemic Sound subscription". The MCP server's own licence agreement covers only the software and states that it grants no rights in the music. It also forbids using the music to train AI models.
The MCP docs say nothing different about YouTube claims, so nothing changes there. Safelist your channel in the Safelisting section of your Epidemic Sound account before you publish (it needs an active subscription), and if a claim appears, follow the steps on the Epidemic Sound claim page. Videos published while you subscribe stay cleared after you cancel; new ones do not.
Common questions
Do you need a paid Epidemic Sound plan to use the MCP server?
To download, yes. Epidemic Sound's docs say a free account can search and preview, and downloading needs an active paid subscription.
Does the free Epidemic Sound developer API key work with the MCP server?
No. The MCP server is a separate product. It uses your own Epidemic Sound account, or a key created under Account, then API keys. A key from the Developer Portal does not work with it.
Can you use the Epidemic Sound MCP server in ChatGPT?
Yes. Epidemic Sound lists ChatGPT as a client that connects by signing in with your Epidemic Sound account. You add it as a custom MCP server with the server address.
Is music downloaded through the MCP server licensed for your videos?
Epidemic Sound says the music and sound effects are licensed through your Epidemic Sound subscription, the same as a download from the website. The MCP server's own licence covers only the software.
Sources
- MCP Server (Beta), Epidemic Sound developer docsdevelopers.epidemicsound.com
- Getting Started with the API (Epidemic Sound Help)epidemicsoundhelp.com
- Epidemic Sound MCP Server Software License Agreementepidemicsound.com
- Safelist channels (Epidemic Sound Help)epidemicsoundhelp.com
- What happens to content when a subscription is canceled? (Epidemic Sound Help)epidemicsoundhelp.com
Facts checked against the sources below on . Licences and prices change, so read the provider's own page before you rely on one.