Listennotes Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Listennotes MCP or direct API to search podcasts, fetch episodes, curate playlists, and explore trending shows through natural language.
BOOK A CALLGET STARTED FOR FREE
Listennotes Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Supported Tools

Tools
Post episodes by idsThe listennotestest episodes post endpoint allows users to retrieve metadata for multiple podcast episodes in a single request.
Create podcast via form dataThe listennotestest podcasts post endpoint allows users to retrieve information about multiple podcasts using various identifiers such as listen notes ids, rss feed urls, apple podcasts ids, or spotify ids.
Retrieve curated podcast by idRetrieves detailed information about a specific curated podcast using its unique identifier.
Fetch best podcasts listThe getbestpodcasts endpoint retrieves a curated list of the best podcasts from the listen notes platform.
Retrieve genre listThe getgenres endpoint retrieves a comprehensive list of available genres within the listennotestest platform.
Get playlistsRetrieves a list of playlists from the listen notes platform.
Listen to just listen endpointThe 'just listen' endpoint is a basic listener or health check mechanism for the listennotestest app.
Get podcast audience by idRetrieves audience information for a specific podcast identified by its unique id.
Get curated podcastsRetrieves a list of curated podcasts from the listen notes platform.
Retrieve episode by idRetrieves detailed information about a specific episode using its unique identifier.
Fetch Podcast Details And EpisodesRetrieves detailed information about a specific podcast using its unique identifier.
Fetch podcast languagesRetrieves a list of supported languages in the listen notes api.
Get podcast domains by nameRetrieves a list of podcasts associated with a specified domain name.
Get episode recommendations by idRetrieves a list of recommended podcast episodes based on a specific episode id.
Get podcast recommendations by idRetrieves a list of podcast recommendations based on a specified podcast id.
Fetch related searches dataRetrieves a list of related search queries based on the current context or user's recent search activity.
Fetch Supported RegionsRetrieves information about available regions in the listennotestest platform.
Retrieve trending searchesRetrieves a list of currently trending search terms related to podcasts.
Search Episode TitlesThe search episode titles endpoint allows users to search for and retrieve episode titles based on specified criteria.
Search operation endpointThe search endpoint allows users to query notifications or events within the listennotestest platform.
Fetch Playlist InfoRetrieves detailed information about a specific playlist using its unique identifier.
Post podcast rss by idRetrieves or generates an rss feed for a specific podcast identified by its unique id.
Delete podcast by idDeletes a specific podcast from the system based on its unique identifier.
Spell check retrievalThe spellcheck endpoint provides a spell-checking service for text input.
Submit podcast rss urlThe submit podcast endpoint allows users to submit a podcast for inclusion in the listen notes database.
Get typeahead suggestionsThe typeahead endpoint provides real-time search suggestions as users type their queries.

Why Use Composio?

AI Native Listennotes Integration

  • Supports both Listennotes MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for searching, browsing, and curating podcasts and episodes

Managed Auth

  • Built-in API key management and secure storage
  • Central place to manage, scope, and revoke Listennotes access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Listennotes
  • Scoped, least privilege access to Listennotes resources
  • Full audit trail of agent actions to support review and compliance

Connect Listennotes MCP Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Listennotes tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Fetch best podcasts list in technology genre')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Connect Listennotes API Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio_openai
Install the Composio SDK

Initialize Composio and Create Tool Router Session

python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
Import and initialize Composio client, then create a Tool Router session

Execute Listennotes Tools via Tool Router with Your Agent

python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Find top podcasts in the technology genre'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
Get tools from Tool Router session and execute Listennotes actions with your Agent

Use Listennotes with any AI Agent Framework

Choose a Framework you want to connect Listennotes with

OpenAI Agents SDK

OpenAI Agents SDK

Use Listennotes MCP with OpenAI Agents SDK

Claude Agents SDK

Claude Agents SDK

Use Listennotes MCP with Claude Agents SDK

Google ADK

Google ADK

Use Listennotes MCP with Google ADK

Langchain

Langchain

Use Listennotes MCP with Langchain

AI SDK

AI SDK

Use Listennotes MCP with AI SDK

Mastra AI

Mastra AI

Use Listennotes MCP with Mastra AI

LlamaIndex

LlamaIndex

Use Listennotes MCP with LlamaIndex

CrewAI

CrewAI

Use Listennotes MCP with CrewAI

Pydantic AI

Pydantic AI

Use Listennotes MCP with Pydantic AI

Autogen

Autogen

Use Listennotes MCP with Autogen

Frequently Asked Questions

Do I need my own developer credentials to use Listennotes with Composio?

Yes, Listennotes requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free