Safari with "Block All Cookies" enabled is not supported
This setting prevents the app from working correctly, including account creation and login.
MCP for AI workspaces

Bring YouTube comment research into your AI workspace

Connect ChatGPT, Gemini, Claude, Grok, or Perplexity to YouTube Comments Downloader. Your AI can download comments and transcripts, follow progress, and analyze the result without leaving the conversation.

Connect your AI appExplore the tools
Example workflow

“Download the comments from this video and tell me what viewers ask about most.”

  1. 1
    Your AI starts the download
    download_youtube_comments
  2. 2
    It checks progress until the download finishes
    get_youtube_download
  3. 3
    The file comes back for analysis
    get_youtube_download_file
6
MCP tools
6
File formats
5
AI apps
What you can do

Collect and interpret in the same place

Connect your AI app

One URL, your existing account

  1. 1

    Add the server URL

    Paste it into your AI app's connector settings. There's nothing to install.

  2. 2

    Sign in to your account

    Approve the connection with your YouTube Comments Downloader account.

  3. 3

    Ask in plain language

    Your AI discovers the tools on its own and picks the right one for each request.

Step-by-step guides: Claude and ChatGPT.

Set up your AI app

Which AI app do you use?

Server URL
https://api.youtubecommentsdownloader.com/mcp

Try it with a free account, or use it regularly with the subscription. Prepaid credits and the desktop license do not include AI app access.

  1. 1On claude.ai, open Customize → Connectors, click + Add, then Add custom connector.
  2. 2Name it YouTube Comments Downloader, paste the server URL, and click Continue twice.
  3. 3Choose Sign in now and, for the OAuth client, Register automatically. Click Add, then sign in and approve.
Step-by-step guide for Claude

Available on every Claude plan, including Free, which allows one custom connector. On Team and Enterprise, an owner adds it first.Setup help

Tool reference

Every tool, with real inputs and responses

6 tools. Open any of them to see what it does, what it accepts, and what comes back.

Comment downloads

The same downloads as the app: same formats, same history.

download_youtube_commentsDownload comments
Uses credits
  • Starts the download and returns straight away with status created. Comments are collected in the background.
  • Uses 1 credit per comment plus 100 credits per video, from your plan.
  • Playlists and channels run as one bulk download that covers their selected items.

Parameters

contentTypestringrequired
What the URL points to: video, short, live, playlist, channel, or community.
urlstringrequired
A YouTube URL for the content.
itemsTypestringoptional
Required for playlist and channel. Which items to download: video, short, community, live-chat (live stream chat replays), or live-comments (regular comments from live streams).
Example call
{
  "name": "download_youtube_comments",
  "arguments": {
    "contentType": "video",
    "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw"
  }
}
Example response
{
  "id": "k3x9q2m7a1b5c8d",
  "status": "created",
  "contentType": "video",
  "mode": "single",
  "progressUrl": "https://youtubecommentsdownloader.com/download/single/k3x9q2m7a1b5c8d"
}
get_youtube_downloadCheck a download's progress
Read-only
  • Returns the download's current status: created, downloading, finished, error, or canceled.
  • Once the download finishes, it includes the comment count and the finish time. Failed downloads include an error code and message.

Parameters

idstringrequired
The download ID returned when the download was started.
Example call
{
  "name": "get_youtube_download",
  "arguments": {
    "id": "k3x9q2m7a1b5c8d"
  }
}
Example response
{
  "id": "k3x9q2m7a1b5c8d",
  "status": "finished",
  "contentType": "video",
  "source": {
    "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw",
    "title": "Me at the zoo"
  },
  "created": "2026-10-13 09:41:05.120Z",
  "updated": "2026-10-13 09:42:31.884Z",
  "finished": "2026-10-13 09:42:31.884Z",
  "commentsCount": 10342,
  "progressUrl": "https://youtubecommentsdownloader.com/download/single/k3x9q2m7a1b5c8d"
}
list_youtube_downloadsList your downloads
Read-only
  • Lists the downloads on your account, including the ones you started in the app.
  • Results are paginated. Filter by status, content type, or creation date.

Parameters

pagenumberoptional
Page number. Defaults to 1.
limitnumberoptional
Results per page, up to 100. Defaults to 20.
statusstringoptional
Only downloads with this status: created, downloading, finished, error, or canceled.
contentTypestringoptional
Only downloads of this type: video, short, live, playlist, channel, or community.
sortstringoptional
created, updated, finished, status, or contentType. Put a minus sign in front for descending order. Defaults to -created, newest first.
createdAfterstringoptional
Only downloads started after this date and time, in ISO 8601 format.
Example call
{
  "name": "list_youtube_downloads",
  "arguments": {
    "status": "finished",
    "sort": "-created",
    "limit": 2
  }
}
Example response
{
  "downloads": [
    {
      "id": "k3x9q2m7a1b5c8d",
      "status": "finished",
      "contentType": "video",
      "source": {
        "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw",
        "title": "Me at the zoo"
      },
      "finished": "2026-10-13 09:42:31.884Z",
      "commentsCount": 10342,
      "progressUrl": "https://youtubecommentsdownloader.com/download/single/k3x9q2m7a1b5c8d"
    }
  ],
  "page": 1,
  "limit": 2,
  "total": 1,
  "nextPage": null
}
get_youtube_download_fileGet the file URL
Read-only
  • Returns the file URL after checking the download status. Active downloads return not_ready; the file endpoint determines availability of completed or partial results.
  • Anyone with the URL can download the file, the same as file links in the app.

Parameters

idstringrequired
The download ID.
formatstringoptional
json, csv, html, xlsx, or txt. Defaults to json. Bulk downloads are ZIP archives containing that data format.
Example call
{
  "name": "get_youtube_download_file",
  "arguments": {
    "id": "k3x9q2m7a1b5c8d",
    "format": "csv"
  }
}
Example response
{
  "id": "k3x9q2m7a1b5c8d",
  "status": "finished",
  "availability": "check_download_endpoint",
  "message": "Follow the link to download. The endpoint determines whether a file is available.",
  "format": "csv",
  "url": "https://api.youtubecommentsdownloader.com/v1/downloads/k3x9q2m7a1b5c8d/save?format=csv"
}

Transcripts and channel tools

Quick lookups that finish within the call and save the result as a JSON file.

get_youtube_transcriptGet a video transcript
Uses credits
  • Collects the transcript of a video, Short, or live stream, with the start time of every line, plus the title, channel, and description.
  • Accepts a YouTube URL or an 11-character video ID.
  • Uses 100 credits, plus 100 for every started 10 minutes of transcript. The result is saved as a JSON file at fileUrl.

Parameters

videostringrequired
A video, Short, or live stream URL, or a video ID.
Example call
{
  "name": "get_youtube_transcript",
  "arguments": {
    "video": "https://www.youtube.com/watch?v=jNQXAC9IVRw"
  }
}
Example response
{
  "downloadId": "t5r1n8s2c6p4t0x",
  "fileUrl": "https://api.youtubecommentsdownloader.com/v1/tools/transcripts/t5r1n8s2c6p4t0x.json"
}
get_youtube_channel_detailsGet channel details
Uses credits
  • Collects the channel's title, description, country, subscriber, view, and video counts, join date, links, avatar, and banner.
  • In bulk mode, url takes several channel URLs separated by spaces, commas, or new lines.
  • Uses 100 credits per channel. The result is saved as a JSON file at fileUrl.

Parameters

urlstringrequired
A channel URL, or several in bulk mode.
modestringrequired
single for one channel, bulk for several.
Example call
{
  "name": "get_youtube_channel_details",
  "arguments": {
    "url": "https://www.youtube.com/@YouTube",
    "mode": "single"
  }
}
Example response
{
  "downloadId": "c4n8v2b6x1z9m3l",
  "fileUrl": "https://api.youtubecommentsdownloader.com/v1/tools/channel-details/c4n8v2b6x1z9m3l.json"
}
Results and errors

Predictable answers your AI can act on

  • Every tool returns JSON as text. Download tools return the API response as is; transcript and channel tools add a fileUrl for the saved result.
  • Failed calls are marked as errors and include the HTTP status and the API's error body, so your AI can explain what went wrong or retry.
  • Credits are charged to your account the same way as in the app. If the account is past due or out of credits, the call is refused with a PAYMENT_PAST_DUE or CREDITS_EXHAUSTED error. Prepaid and desktop accounts get UPGRADE_REQUIRED with a link to subscribe.
Example error
{
  "status": 404,
  "body": {
    "code": "NOT_FOUND",
    "message": "Download not found"
  }
}
FAQ

Before you connect

Do I need to know what MCP is?

No. MCP is what lets your AI app use tools from other services. Pick your AI app above and follow the three steps.

Is this different from downloading in the app?

No. Downloads started from your AI client are the same downloads you see in the app, with the same formats, credits, and file links.

Which plan do I need?

You can try it with a free account and its free credits. For regular use, it is included with the subscription. Prepaid credit packs and the desktop app license do not include it. Credits are charged to your account the same way as in the app.

Does the AI read every comment?

The download always contains every comment. How much of the file your AI reads at once depends on the client and model, so ask it to work in batches on very large downloads.

Can it search all comments by keyword?

Not yet. Download the comments first, then ask your AI client to search and analyze the finished file.