How to Use the Listen Notes MCP in Claude Code

Q: How do I add the Listen Notes MCP Server to Claude Code?

You run the claude mcp add command with the Vinkius URL to connect Listen Notes to your terminal. Claude Code connects to the server and registers the tools instantly. Your configuration is saved directly in your local config file.

Q: How does Claude Code handle deep podcast details from Listen Notes?

The command-line tool calls getpodcastdetails with your target podcast ID to extract the full episode history. It formats the massive feed into a clean terminal structure. This is perfect for quick shell scripts and local audits.

Q: Can I check trending searches from my terminal?

Yes, you can check them by telling Claude Code to run gettrendingpodcastsearches. It returns the most popular search terms across the platform. You do not need to open a browser to see what's trending.

Pipe Listen Notes podcast metadata directly into your terminal scripts and CI/CD pipelines using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Listen Notes MCP to Claude Code

Create your Vinkius account to connect Listen Notes to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Listen Notes with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Terminal-Based Podcast Search

`search_podcasts_or_episodes` runs podcast searches directly from your command line interface. Claude Code executes this tool, formatting the raw JSON response into clean terminal output. You can pipe the search results into other terminal utilities like grep or jq. This makes it easy to filter show descriptions or extract audio URLs without leaving your shell.

Automated Genre Mapping and Audits

`list_podcast_genres` fetches the complete list of available podcast genres. Claude Code uses this tool to verify that your application's categorization matches the global standard. The tool outputs numerical genre IDs and their corresponding names. Your agent writes shell scripts to map these IDs to your internal database tables.

Scripted Metadata Extraction via MCP Server

`get_podcast_details` gets the complete feed history and metadata for any podcast ID. Claude Code calls this tool to audit a show's episode count or publication frequency. The output is formatted directly in your terminal. You can configure cron jobs to run this check daily and alert your team if a critical feed changes format.

Setup guide

Set up Listen Notes MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see listen-notes-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Listen Notes transactions." It will automatically discover and invoke the available Listen Notes tools.

Terminal

claude mcp add --transport http listen-notes-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Listen Notes MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "listen-notes-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Listen Notes. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Listen Notes now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Listen Notes MCP in Claude Code

You run the `claude mcp add` command with the Vinkius URL to connect Listen Notes to your terminal. Claude Code connects to the server and registers the tools instantly. Your configuration is saved directly in your local config file.

Yes, you can execute headless searches by instructing the command-line agent to query `search_podcasts_or_episodes`. It outputs the raw JSON directly to your terminal. From there, you can pipe the results into other command-line tools.

The command-line tool calls `get_podcast_details` with your target podcast ID to extract the full episode history. It formats the massive feed into a clean terminal structure. This is perfect for quick shell scripts and local audits.

Yes, you can check them by telling Claude Code to run `get_trending_podcast_searches`. It returns the most popular search terms across the platform. You do not need to open a browser to see what's trending.

Your Listen Notes credentials and command history are stored strictly in your local `~/.claude.json` file. Vinkius handles the secure proxying to the API endpoint without caching your search parameters. No third parties can access your secret keys.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript