How to integrate Listennotes MCP with Codex

Connect Codex to Listennotes MCP. Find top tech podcasts from last week, get audience stats for this podcast, and more using natural language, with authentication handled for you.

Listennotes logoListennotes
Api Key

Listennotes is a powerful podcast search engine with a massive global database. Discover, search, and curate podcasts from around the world in seconds.

26 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Listennotes MCP integration, Codex can search podcasts and episodes, browse best podcast lists, fetch recommendations, check trending searches, and submit podcast RSS feeds, all without leaving the terminal or the app, whichever you prefer.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Listennotes with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Listennotes MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Listennotes task. The first time, Composio asks you to connect your Listennotes account.

For example, ask it to:

  • "Find top tech podcasts from last week"
  • "Get audience stats for this podcast"
  • "List curated playlists about entrepreneurship"

What is the Listennotes MCP server, and what's possible with it?

The Listen Notes MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Listen Notes account. It provides structured and secure access to podcast and episode information, recommendations, curated lists, audience data, and playlists, so your agent can find episodes by title, retrieve podcast details, discover recommendations, review audience demographics, and access playlists on your behalf.

  • Podcast and episode lookup: Have your agent search for episodes by title, retrieve detailed episode information, or fetch a podcast and its episodes.
  • Podcast discovery: Let the agent retrieve best podcast lists, curated collections, trending searches, related search terms, and typeahead suggestions.
  • Personalized recommendations: Direct your agent to find recommended podcasts or episodes based on a podcast or episode you already know.
  • Audience and publisher research: Instruct your agent to review a podcast's audience demographics or find podcasts associated with a publisher's domain.
  • Playlists and podcast submissions: Have your agent fetch your playlists and their details, submit a podcast feed to the Listen Notes database, or request a podcast's deletion.

Conclusion

You've successfully integrated Listennotes with Codex using Composio's MCP server. Now you can interact with Listennotes directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Listennotes operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1700+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Listennotes operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Listennotes action and event your agent gets out of the box.

Post episodes by ids

Retrieves metadata for multiple known podcast episodes by ID in one request.

Create podcast via form data

Retrieves metadata for multiple podcasts by Listen Notes IDs, RSS URLs, Apple Podcasts IDs, or Spotify IDs, with optional latest episodes.

Retrieve curated podcast by id

Retrieves detailed information about a specific curated podcast using its unique identifier.

Fetch best podcasts list

The getBestPodcasts endpoint retrieves a curated list of the best podcasts from the Listen Notes platform.

Retrieve genre list

The GetGenres endpoint retrieves a comprehensive list of available genres within the listennotestest platform.

Get playlists

Retrieves a paginated, sortable list of playlists associated with your Listen Notes account, including basic playlist metadata.

Listen to just listen endpoint

Retrieves a random podcast episode from Listen Notes, with episode metadata and associated podcast information.

Get podcast audience by id

Retrieves audience demographics for a podcast by ID, including audience distribution by region when available.

Get curated podcasts

Retrieves a page of curated podcast lists from Listen Notes, with list metadata and a preview of up to five podcasts in each list.

Retrieve episode by id

Retrieves detailed information about a specific episode using its unique identifier.

Fetch Podcast Details And Episodes

Retrieves detailed metadata for a podcast by ID along with a page of its episodes.

Fetch podcast languages

Retrieves the list of supported podcast languages from Listen Notes for use in content filtering.

Get podcast domains by name

Retrieves a list of podcasts associated with a specified domain name.

Get episode recommendations by id

Retrieves a list of recommended podcast episodes based on a specific episode ID.

Get podcast recommendations by id

Retrieves a list of podcast recommendations based on a specified podcast ID.

Fetch related searches data

Retrieves search terms related to a supplied search query.

Fetch Supported Regions

Retrieves information about available regions in the listennotestest platform.

Retrieve trending searches

Retrieves a list of currently trending search terms related to podcasts.

Search Episode Titles

Searches for podcast episodes by title, optionally restricted to a specified podcast.

Search operation endpoint

Searches Listen Notes for episodes, podcasts, or curated podcast lists using a text query.

Fetch Playlist Info

Retrieves a playlist by ID, including its metadata and a sortable, paginated list of episode, custom audio, or podcast items.

Post podcast rss by id

Requests an RSS feed refresh for a podcast by ID and returns the refresh status and last refresh timestamp when available.

Delete podcast by id

Requests deletion of a podcast by ID, optionally supplying a reason, and returns the request status.

Spell check retrieval

Checks the spelling of a supplied search term and returns misspelled tokens, suggestions, and corrected text with HTML formatting.

Submit podcast rss url

Submits a podcast RSS feed to the Listen Notes database, optionally providing an email for acceptance notifications; submission does not guarantee inclusion.

Get typeahead suggestions

Retrieves typeahead search-term suggestions for a query, with optional podcast and genre suggestions.

FAQ

Frequently asked questions

Start with Listennotes.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Listennotes tool your agent needs.Free to start.

Start building