# Youtube Mcp Server

> Servidor MCP para interactuar con la API de YouTube desde asistentes de IA.

- **Type:** MCP server
- **Install:** `agentstack add mcp-nocodeboy-youtube-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Nocodeboy](https://agentstack.voostack.com/s/nocodeboy)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Nocodeboy](https://github.com/Nocodeboy)
- **Source:** https://github.com/Nocodeboy/youtube-mcp-server

## Install

```sh
agentstack add mcp-nocodeboy-youtube-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# YouTube MCP Server

  
  
  
  

This is an MCP (Model Context Protocol) server that allows Claude and other AI assistants to interact with the YouTube API. The server provides tools to search for videos, get details about specific videos, search for channels, and obtain detailed information about channels.

## What is MCP?

Model Context Protocol (MCP) is an open standard developed by Anthropic (creators of Claude) to connect AI assistants with external data sources and tools. It allows models like Claude to access up-to-date information and perform actions in external systems in a standardized way.

MCP functions as a "universal bridge" for AI, providing a standardized way for models to access various content repositories, business services, or applications.

## Requirements

- Node.js v16 or higher
- A YouTube API key (obtained from the Google Developer Console)

## Installation

1. Clone this repository:
```bash
git clone https://github.com/Nocodeboy/youtube-mcp-server.git
cd youtube-mcp-server
```

2. Install dependencies:
```bash
npm install
```

3. Create a `.env` file in the project root and add your YouTube API key:
```
YOUTUBE_API_KEY=your_api_key_here
```

## Execution

To start the server, run:

```bash
npm start
```

## Integration with Claude Desktop

To use this MCP server with Claude Desktop, add the following configuration to your `claude_desktop_config.json` file (usually located in `%APPDATA%\Claude\` on Windows or `~/Library/Application Support/Claude/` on macOS):

```json
{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["path/to/youtube-mcp-server/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

Replace `"path/to/youtube-mcp-server/index.js"` with the absolute path to the `index.js` file, and `"your_api_key_here"` with your YouTube API key.

## Available Tools

### 1. Search Videos

Search for videos on YouTube based on a query.

```
search_videos
```

Parameters:
- `query` (string, required): Search terms
- `maxResults` (number, optional): Maximum number of results (between 1 and 50)
- `pageToken` (string, optional): Token to get the next page of results

### 2. Get Video Details

Get detailed information about a specific video.

```
get_video_details
```

Parameters:
- `videoId` (string, required): YouTube video ID

### 3. Get Channel Details

Get detailed information about a specific channel.

```
get_channel_details
```

Parameters:
- `channelId` (string, required): YouTube channel ID

### 4. Search Channels

Search for channels on YouTube based on a query.

```
search_channels
```

Parameters:
- `query` (string, required): Search terms
- `maxResults` (number, optional): Maximum number of results (between 1 and 50)
- `pageToken` (string, optional): Token to get the next page of results

## Available Resources

- `youtube://popular/videos`: List of currently popular videos on YouTube

## Usage Examples

With Claude Desktop, you can ask questions like:

- "Search for Python programming videos"
- "Show me details of video with ID dQw4w9WgXcQ"
- "Search for cooking-related channels"
- "Give me information about the GoogleDevelopers channel"
- "What are the most popular videos right now?"

## Getting a YouTube API Key

To get a YouTube API key:

1. Go to the [Google Developer Console](https://console.developers.google.com/)
2. Create a new project (or select an existing one)
3. In the sidebar, select "API Library"
4. Search for "YouTube Data API v3" and enable it
5. In the sidebar, select "Credentials"
6. Click on "Create credentials" and select "API key"
7. Copy the generated key and use it in your `.env` file or in the Claude Desktop configuration

## Troubleshooting

If you encounter errors, check:

1. That you have installed all dependencies with `npm install`
2. That your YouTube API key is valid
3. That you have the YouTube Data API v3 enabled in your Google project
4. That you are using Node.js version 16 or higher
5. If you use Claude Desktop, check the logs in `%APPDATA%\Claude\logs\` (Windows) or `~/Library/Logs/Claude/` (macOS)

## Contributions

Contributions are welcome. You can collaborate in several ways:

1. Reporting bugs or issues
2. Suggesting new features
3. Sending pull requests with improvements or fixes
4. Improving documentation

## Connect & Support

- Follow me on X (Twitter): [@Nocodeboy](https://x.com/Nocodeboy)
- If you find this project useful and want to show your support:

## License

This project is licensed under the MIT License. See the LICENSE file for more details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Nocodeboy](https://github.com/Nocodeboy)
- **Source:** [Nocodeboy/youtube-mcp-server](https://github.com/Nocodeboy/youtube-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-nocodeboy-youtube-mcp-server
- Seller: https://agentstack.voostack.com/s/nocodeboy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.