# metube-mcp

MCP server for [MeTube](https://github.com/alexta69/metube) — control your yt-dlp web GUI from any AI assistant.

## Tools

| Tool | Description |
|------|-------------|
| `metube_add_download` | Queue a video/audio download (URL, quality, format, folder) |
| `metube_list_downloads` | List queued, active, and completed downloads |
| `metube_delete_downloads` | Remove items from queue or history |
| `metube_start_downloads` | Start pending downloads |
| `metube_cancel_add` | Cancel current add operation |
| `metube_get_version` | Get MeTube and yt-dlp versions |
| `metube_cookie_status` | Check if cookies are configured |
| `metube_upload_cookies` | Upload cookies for authenticated downloads |
| `metube_delete_cookies` | Remove uploaded cookies |

## Setup

### Claude Code

```json
{
  "mcpServers": {
    "metube": {
      "command": "uvx",
      "args": ["metube-mcp"],
      "env": {
        "METUBE_URL": "http://localhost:8081"
      }
    }
  }
}
```

### From source

```json
{
  "mcpServers": {
    "metube": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ishevchenko/metube-mcp", "metube-mcp"],
      "env": {
        "METUBE_URL": "http://localhost:8081"
      }
    }
  }
}
```

## Configuration

| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `METUBE_URL` | `http://localhost:8081` | MeTube instance URL |

## Development

```bash
git clone https://github.com/ishevchenko/metube-mcp.git
cd metube-mcp
pip install -e .
METUBE_URL=http://localhost:8081 metube-mcp
```

## License

MIT