# youtube-kit

> youtube-kit is a free MCP server for design and media. YouTube CLI and MCP server for analytics, transcripts, uploads and comment moderation. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/eukosh/youtube-kit
- **MCP Registry name:** io.github.eukosh/youtube-kit
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

youtube-kit ships a command-line tool (ytk) and an MCP server that share the same operations, so an agent can work on your channel or you can run the commands yourself. You use your own Google Cloud project and OAuth client, which the README explains gives your channels their own 10,000-unit daily quota rather than splitting one among all users. The first login takes about five minutes, and the setup_guide tool can walk an assistant through it.

It covers analytics broken down by video, country, device or traffic source, thumbnail click-through rate, video upload and metadata edits, captions and transcripts, comments (including held for review and spam), playlists, channel details, search and subscriptions. Several channels, including brand channels, can be logged in and selected per call with my_channel. Localizations, live streaming and memberships are not covered.

It installs from PyPI with uv and runs locally over stdio.

## Features

- **Channel analytics:** Breaks down views by many dimensions and retention.
- **Uploads and metadata:** Uploads videos, edits metadata and sets thumbnails.
- **Transcripts:** Pulls captions or automatic transcripts for your videos.
- **Comment moderation:** Approves, holds, rejects or bans from comment lists.
- **Multiple channels:** Switches between logged-in channels per command.
- **Public search:** Reads public videos, channels and playlists.

## Good for

- Ask which videos got the most views this month
- Review comments held for moderation
- Upload a clip with title and thumbnail
- Fetch a transcript for repurposing a video

## Install

### Claude Code (Terminal)

```sh
claude mcp add youtube-kit --env YOUTUBE_API_KEY='<YOUTUBE_API_KEY>' -- uvx youtube-kit
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "youtube-kit": {
      "command": "uvx",
      "args": [
        "youtube-kit"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "youtube-kit": {
      "command": "uvx",
      "args": [
        "youtube-kit"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "youtube-kit": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "youtube-kit"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "youtube-kit": {
      "command": "uvx",
      "args": [
        "youtube-kit"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "youtube-kit": {
      "command": "uvx",
      "args": [
        "youtube-kit"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `setup_guide`: Walks the model through Google Cloud and login setup.

## FAQ

### Do I need my own Google Cloud setup?

Yes, a one-time project and OAuth client, which the guided login helps with.

### Can it read public channels without logging in?

Public data works with a YOUTUBE_API_KEY or through your login.

### What is not covered?

Localizations, live streaming and channel memberships.

### How do I install it?

uv tool install youtube-kit, or run uvx youtube-kit mcp.

### Is youtube-kit free?

Yes. youtube-kit is free to use.

### How do I add youtube-kit to Claude Code?

Run this command in your terminal: claude mcp add youtube-kit --env YOUTUBE_API_KEY='<YOUTUBE_API_KEY>' -- uvx youtube-kit

### What are the best alternatives to youtube-kit?

The closest alternatives to youtube-kit are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and Agent-Native Analytics.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.

---
Source: https://ai-powered.com/mcp/youtube-kit
