Listen Notes integration

Quick start

Call Listen Notes from your generated app's worker code via the OverSkill composio client. The toolkit slug below maps to Listen Notes's public Composio identifier — your app references it by name and OverSkill handles the OAuth round-trip.

// In your generated app's worker handler:
const composio = composioClient(env);

const result = await composio.execute(
  "LISTENNOTES_ACTION_NAME",
  { /* action parameters — see Actions section below */ }
);

return new Response(JSON.stringify(result), {
  headers: { "Content-Type": "application/json" }
});

Replace ACTION_NAME with one of the slugs listed in the Actions section below. The composio client handles auth + rate limits automatically — no API key is exposed to user code.

Setup

End-users supply their own Listen Notes API key. OverSkill provides a pre-built connection form via the integration card — your app can call the composio client immediately once the user has connected.

Available actions

26 actions exposed via the Listen Notes integration. Each maps to a callable slug — pass it to composio.execute(...) in your worker code.

• LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES
• LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS
• LISTENNOTES_FETCH_A_CURATED_LIST_OF_PODCASTS_BY_ID
• LISTENNOTES_FETCH_A_LIST_OF_BEST_PODCASTS_BY_GENRE
• LISTENNOTES_FETCH_A_LIST_OF_PODCAST_GENRES
• LISTENNOTES_FETCH_A_LIST_OF_YOUR_PLAYLISTS
• LISTENNOTES_FETCH_A_RANDOM_PODCAST_EPISODE
• LISTENNOTES_FETCH_AUDIENCE_DEMOGRAPHICS_FOR_A_PODCAST
• LISTENNOTES_FETCH_CURATED_LISTS_OF_PODCASTS
• LISTENNOTES_FETCH_DETAILED_META_DATA_FOR_AN_EPISODE_BY_ID
• LISTENNOTES_FETCH_PODCAST_EPISODES_BY_ID
• LISTENNOTES_FETCH_PODCAST_LANGUAGES