ListenHub MCP

How to Install and Use ListenHub MCP

ListenHub MCP is an official server for ListenHub that helps you generate AI podcasts, create FlowSpeech voice content, and manage speakers and user accounts. To use it, you need to install and configure it properly. This guide will walk you through the installation process and setting up ListenHub MCP with easy steps and examples.

Step 1: Install Node.js

ListenHub MCP requires Node.js version 18 or higher. First, you need to install Node.js on your computer. The instructions vary by your operating system.

• For macOS, you can use the official installer:

  1. Visit the Node.js official website.
  2. Download the Long Term Support (LTS) version, for example, v24.11.0(LTS).
  3. Open the downloaded .pkg file and follow the instructions.
  4. Once installed, open the Terminal and run:

     node --version
     npm --version
     

     This checks if Node.js and npm are installed correctly.

• For Windows, use the official installer:

  1. Download the LTS version from the Node.js official website.
  2. Run the .msi installer and follow the setup steps.
  3. Open PowerShell, then check installation with:

     node --version
     npm --version
     

• For Linux (Ubuntu/Debian):

  Open a terminal and run:

  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
  sudo apt-get install -y nodejs
  node --version
  npm --version
  

This ensures your system has the right Node.js version.

Step 2: Get Your ListenHub API Key

To use ListenHub MCP, you must have an API key. Here’s how to get it:

• Go to the ListenHub API Keys Settings page.
• Copy your API key.
• You will use this API key in your configuration later.

Step 3: Configure ListenHub MCP for Your Client

Now that you have Node.js installed and your API key, it's time to set up ListenHub MCP with your preferred MCP client. The configuration usually looks similar across clients.

For example, here is a standard configuration JSON you will add to your client configuration file:

{
  "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 actual API key from ListenHub.

Step 4: Example Configurations for Popular MCP Clients

• Claude Desktop:

  Edit claude_desktop_config.json as follows (macOS path shown):

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

  Insert the JSON configuration from Step 3.

• Cursor:

  Open settings → Features → Model Context Protocol. Add the JSON above in the file:

  ~/.cursor/mcp.json
  

• Windsurf:

  Edit the MCP server configuration at:

  ~/.windsurf/mcp_server_config.json
  

• VS Code (Cline Extension):

  Open settings and look for "Cline: MCP Settings". Edit settings.json and add the snippet from Step 3.

• Zed Editor:

  Modify MCP config at:

  ~/.config/zed/mcp.json
  

• Claude CLI:

  Run this command in your terminal:

  claude mcp add listenhub --env LISTENHUB_API_KEY=<your_api_key> -- npx -y @marswave/listenhub-mcp-server
  

• Codex CLI:

  Run:

  codex mcp add listenhub --env LISTENHUB_API_KEY=<your_api_key> -- npx -y @marswave/listenhub-mcp-server
  

Replace <your_api_key> with your real API key.

Step 5: Optional - Run ListenHub MCP in HTTP Mode

If you want to use HTTP transport instead of the default stdio mode, start the server manually.

• On macOS/Linux:

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

• On Windows (PowerShell):

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

Then configure your MCP client with:

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

---

By following these steps, you will have ListenHub MCP installed and configured with your system and preferred tools. Now you can enjoy AI-powered podcast generation, FlowSpeech voice creation, and more with ListenHub MCP!