Quick Start

Install Node.js, get an API key, and connect the ListenHub MCP server to your client.

ListenHub provides an official MCP server for AI podcast generation (single or dual host), FlowSpeech narration, and related capabilities.

The MCP server is available to all ListenHub users with an API key. An API key is generated automatically for any ListenHub account — there is no plan gate to connect the server. Generating podcasts, FlowSpeech, and audio consumes credits according to your plan. Use the get_user_subscription tool, or the */estimate-credits endpoints, to check balances and estimate cost before you generate.

Quick Start

Environment Setup

Install Node.js first.

The MCP server requires Node.js 18 or newer. If Node.js is not installed yet, follow one of the options below.

macOS

Option 1: Official installer
1. Visit the Node.js website and download an LTS release, for example v24.11.0 (LTS)
2. Open the downloaded .pkg file and follow the installer
3. Verify installation in terminal:
```
node --version
npm --version
```
Option 2: Homebrew

If Homebrew is not installed, install it with:
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
Then install Node.js:
```
brew install node
```
Verify installation:
```
node --version
npm --version
```
Windows

Option 1: Official installer
1. Visit the Node.js website
2. Download the Windows LTS version
3. Run the downloaded .msi installer
4. Follow the setup wizard
5. Verify installation in PowerShell:
```
node --version
npm --version
```
Option 2: winget

For Windows 10 version 1809 or newer:
```
winget install OpenJS.NodeJS.LTS
```
Verify installation:
```
node --version
npm --version
```
Option 3: Chocolatey

If Chocolatey is available:
```
choco install nodejs-lts
```
Verify installation:
```
node --version
npm --version
```

Linux

Ubuntu/Debian

# Install Node.js 20.x (LTS)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora/RHEL/CentOS

# Install Node.js 20.x (LTS)
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

Verify installation:

node --version
npm --version

Get a ListenHub API key.

Create or view your API key on the ListenHub API key settings page, then set it as the environment variable LISTENHUB_API_KEY. Keep the key on the server side — it grants full access to your account's credits.

Client Configuration Methods

Claude Desktop

Edit Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\\Claude\\claude_desktop_config.json

Add:

{
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with the real API key.

Cursor

Open Cursor Settings
Navigate to Features -> Model Context Protocol
Click Add MCP Server or edit config file directly

Config file location:

macOS/Linux: ~/.cursor/mcp.json
Windows: %APPDATA%\\Cursor\\mcp.json

Add:

{
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with the real API key.

Optional: HTTP transport mode

Start server manually:

export LISTENHUB_API_KEY="your_api_key_here"
npx @marswave/listenhub-mcp-server --transport http --port 3000

Then configure Cursor:

{
  "mcpServers": {
    "listenhub": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Windsurf

Open Windsurf Settings
Navigate to MCP Servers
Add a new server config

Config file location:

macOS/Linux: ~/.windsurf/mcp_server_config.json
Windows: %APPDATA%\\Windsurf\\mcp_server_config.json

Add:

{
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with the real API key.

VS Code (with Cline extension)

Install Cline extension from VS Code Marketplace
Open VS Code Settings
Search for Cline: MCP Settings
Click Edit in settings.json

Add:

{
  "cline.mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with the real API key.

Zed

Open Zed Settings
Go to MCP section
Edit config file

Config file location:

macOS/Linux: ~/.config/zed/mcp.json
Windows: %APPDATA%\\Zed\\mcp.json

Add:

{
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with the real API key.

Claude CLI

Run in terminal:

claude mcp add listenhub --env LISTENHUB_API_KEY=<insert-your-api-key-here> -- npx -y @marswave/listenhub-mcp-server

Replace <insert-your-api-key-here> with the real API key.

Codex CLI

Run in terminal:

codex mcp add listenhub --env LISTENHUB_API_KEY=<insert-your-api-key-here> -- npx -y @marswave/listenhub-mcp-server

Replace <insert-your-api-key-here> with the real API key.

ChatWise
1. Open ChatWise settings, choose MCP, and click + to add a new MCP service
2. Fill in MCP config fields:
- Command: npx -y @marswave/listenhub-mcp-server@latest
- Enable Run tools automatically
- Add environment variable LISTENHUB_API_KEY with your key value
1. Enable tools from the chat input area and start using them

Other MCP clients

For other MCP-compatible clients, use the standard MCP format:

{
  "mcpServers": {
    "listenhub": {
      "command": "npx",
      "args": ["-y", "@marswave/listenhub-mcp-server@latest"],
      "env": {
        "LISTENHUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with the real API key.

Quick Start

Quick Start

Environment Setup

Client Configuration Methods

Next Steps

Usage Examples

Available Tools

On this page