🎙️ Podbean MCP Server 🎧

An MCP server for managing your podcast through the Podbean API.

🎉 Overview

This MCP server connects any MCP-compatible AI assistant to the Podbean API. Whether you're using Cline (the IDE MCP Client), Claude Desktop, or any other MCP client, you can now manage your podcasts, episodes, and analytics through natural conversation!

✨ Features

🔐 Authentication

• Client credentials authentication for managing your own podcasts
• OAuth flow for third-party access (when needed)
• Token management for multiple podcasts - juggle them all!

🎙️ Podcast Management

• List all your awesome podcasts in one place
• Get the nitty-gritty details about your shows
• Peek at your stats and analytics (who's listening?)
• Browse podcast categories to find your niche

📝 Episode Management

• See all episodes for your podcast at a glance
• Dig into the details of any episode
• Publish new episodes with ease (no more complex forms!)
• Update existing episodes when you need a tweak
• Delete episodes that didn't quite hit the mark

📁 File Management (Limited)

• Get authorization for file uploads to Podbean (presigned URLs)
• Note: Due to STDIO protocol limitations, this server cannot directly upload files
• The server provides the necessary authorization and file keys, but actual file uploads must be handled externally

📊 Analytics

• Check out how many downloads your podcast is getting
• Track your daily listener counts (watching them grow!)
• See how users are interacting with your content

🌐 Public Podcast Access

• Access public podcast data through oEmbed
• Get the scoop on any public episode out there

🧰 Prerequisites

• Python 3.10 or higher (time to upgrade if you haven't already!)
• A Podbean account with API access (free or paid - they're all welcome)
• Podbean API credentials (Client ID and Secret - your magical keys to the kingdom)

🚀 Installation

Installing via Smithery

To install Podbean Podcast Manager for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @amurshak/podbeanmcp --client claude

1. Grab the code:

   git clone <repository-url>
   cd PodbeanMCP
   

2. Set up a virtual environment using the super-speedy uv tool:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install the package and its dependencies:

   # Using uv (faster)
   uv pip install -e .
   

   Or if you prefer traditional pip:

   pip install -e .
   

   This will install all dependencies from the pyproject.toml file, including:

   • mcp[cli] (MCP SDK)
   • httpx (for API requests)
   • python-dotenv (for environment variables)
   • pydantic (for data validation)

4. Create a .env file with your secret Podbean powers:

   PODBEAN_CLIENT_ID=your_client_id
   PODBEAN_CLIENT_SECRET=your_client_secret
   

📝 Configuring in cline_mcp_settings.json

The recommended way to use this MCP server is to configure it directly in your cline_mcp_settings.json file. This allows the Cline IDE MCP Client to automatically start the server when needed.

1. Locate your cline_mcp_settings.json file. This file is used by Cline IDE to configure MCP servers. Refer to the Cline IDE documentation for the exact location of this file on your system.

2. Add the Podbean MCP server configuration to the "mcpServers" object:

{
  "mcpServers": {
    "Podbean MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/full/path/to/PodbeanMCP/server.py"
      ],
      "env": {
        "PODBEAN_CLIENT_ID": "your_client_id",
        "PODBEAN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

3. Customize the co

... View full README on GitHub