Integration

Listen Notes integration

Listen Notes is a podcast search engine and directory. Search podcasts, episodes and curated lists by keyword, find episodes by title, get podcast and episode details with their audio URLs, browse best podcasts by genre and region, get recommendations and audience by region, look up podcasts by publisher domain, submit or refresh a podcast RSS feed, and manage your own playlists. Batch fetch, related searches, spellcheck and RSS refresh need a PRO or ENTERPRISE plan. The deletion request reserved for podcast hosting services is not included. Authentication is an API key sent in the X-ListenAPI-Key header.

Connect Listen Notes How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Listen Notes.Built from the 31 Listen Notes tools below, on the connection you add once.

What you can do with Listen Notes

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Playlist, 5 operations

create_playlistCreate playlistPOSTCreate an empty playlist owned by the API admin. Name is required; description defaults to an empty string, visibility defaults to public, and type defaults to episode_list.
delete_playlistDelete playlistDELETEPermanently delete a playlist, including all episode and podcast references saved in this specific playlist and their notes.
get_playlistGet playlistGETFetch a playlist's details and its items (episodes, custom audio or podcasts). A playlist holds episodes and podcasts in two views: type selects episode_list or podcast_list, else the saved default view is used.
list_playlistsList playlistsGETThis endpoint lists playlists with an active membership for the API admin, including playlists they created or joined.
update_playlistUpdate playlistPUTUpdate any subset of name, description, visibility, and type. Omitted fields remain unchanged; at least one field is required. Switching to private rotates the playlist RSS secret.

Item, 3 operations

add_playlist_itemAdd playlist itemPOSTAdd an episode or a podcast to a playlist, with optional notes. Provide exactly one non-empty episode_id or podcast_id; an empty unused ID field is ignored. An item already in the playlist is reused (notes replaced only when supplied).
delete_playlist_itemDelete playlist itemDELETEDelete a playlist item. Repeating deletion of the same item succeeds. This does not delete the episode or podcast from the podcast database.
update_playlist_item_notesUpdate playlist item notesPUTReplace the notes of one playlist item, or send an empty string to clear them. The item ID and added_at_ms remain unchanged.

Curated podcast, 2 operations

get_curated_podcastGet curated podcastGETGet detailed meta data of all podcasts in a specific curated list. This endpoint returns same data as https://www.listennotes.com/curated-podcasts/
list_curated_podcastsList curated podcastsGETList curated lists of podcasts from online media, one page at a time. For each list you get basic info of up to 5 podcasts; get_curated_podcast returns all podcasts of one list.

Episode, 2 operations

batch_get_episodesBatch get episodesPOSTBatch fetch basic meta data for up to 10 episodes by id. For full details of one episode use get_episode. Available only in the PRO/ENTERPRISE plan.
get_episodeGet episodeGETFetch detailed meta data for a specific episode.

Podcast, 2 operations

batch_get_podcastsBatch get podcastsPOSTBatch fetch basic meta data for up to 10 podcasts, by Listen Notes id, RSS URL, Apple Podcasts id or Spotify id (for example to import an OPML list). Available only in the PRO/ENTERPRISE plan.
get_podcastGet podcastGETFetch detailed meta data and episodes for a specific podcast (up to 10 episodes each time).

Recommendation, 2 operations

list_episode_recommendationsList episode recommendationsGETFetch up to 8 episode recommendations based on the given episode id.
list_podcast_recommendationsList podcast recommendationsGETFetch up to 8 podcast recommendations based on the given podcast id.

Audience, 1 operation

get_podcast_audienceGet podcast audienceGETFetch the audience breakdown by region for a podcast (the share of listeners per country code), as measured on the Listen Notes platform. Not every podcast has data.

Best podcast, 1 operation

list_best_podcastsList best podcastsGETGet a list of curated best podcasts by genre, which are curated by Listen Notes staffs based on various signals from the Internet, e.g., top charts on other podcast platforms.

Domain, 1 operation

list_podcasts_by_domainList podcasts by domainGETFetch podcasts by a publisher's domain name, e.g., nytimes.com, wondery.com, npr.org... Each request will return up to 10 podcasts. You can use the `page` parameter to paginate.

Genre, 1 operation

list_genresList genresGETGet a list of podcast genres that are supported in Listen Notes.

Just listen, 1 operation

get_random_episodeGet random episodeGETFetch one random podcast episode with its details and audio URL. Recently published episodes are more likely to be returned.

Language, 1 operation

list_languagesList languagesGETGet a list of languages that are supported in Listen Notes database. You can use the language string as query parameter in `search`.

Region, 1 operation

list_regionsList regionsGETList the country and region codes Listen Notes supports (for example us, gb) with their names. Pass a code as region to list_best_podcasts.

Related searche, 1 operation

list_related_searchesList related searchesGETSuggest related search terms. The results are more comprehensive than from `typeahead`. This endpoint is available only in the PRO/ENTERPRISE plan.

Rs, 1 operation

refresh_rssRefresh rssPOSTRefresh a podcast's RSS feed. Each podcast is limited to one refresh per hour.

Search, 1 operation

searchSearchGETFull-text search on episodes, podcasts, or curated lists of podcasts. Use the `offset` parameter to paginate through search results.

Search episode title, 1 operation

search_episode_titlesSearch episode titlesGETConduct targeted searches for individual episodes by title and refine results using the podcast id such as Listen Notes Podcast ID, Apple Podcasts ID, Spotify ID, or RSS feed URL.

Spellcheck, 1 operation

spellcheckSpellcheckGETSuggest a list of words that correct the spelling errors of a search term. This endpoint is available only in the PRO/ENTERPRISE plan.

Submit, 1 operation

submit_podcastSubmit podcastPOSTPodcast hosting services can use this endpoint to help your users directly submit a new podcast to Listen Notes database.

Trending searche, 1 operation

list_trending_searchesList trending searchesGETFetch up to 10 most recent trending search terms on the Listen Notes platform.

Typeahead, 1 operation

typeaheadTypeaheadGETSuggest search terms, podcast genres, and podcasts.

Use Listen Notes from Claude Code, Cursor or Codex

Connect Listen Notes in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Listen Notes operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Listen Notes

Create your workspace
Sign up free. Nothing to install.
Connect Listen Notes once
Add your Listen Notes connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.