YouTube is the world’s largest video platform with billions of users. The YouTube MCP server lets you search videos, get channel data, and collect comments using natural language.
What Can It Do?
- Search videos by keyword with filters
- Get video details with full metadata
- Analyze channels and their content
- Collect comments for sentiment analysis
Where to Use It
In Agents (Recommended)
Add YouTube as a tool to any agent. The agent can then search and analyze YouTube data conversationally, choosing the right actions based on context.
To add an MCP tool to your agent:
- Open your agent’s configuration
- Click Add tools → Connect an app with MCP
- Search for the integration and select it
- Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.
In Workflows (Via Agent Node)
For automated pipelines, use an Agent Node with YouTube tools. This gives you the flexibility of an agent within a deterministic workflow.
As a Custom MCP Node
You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
- Go to your node library and search for the integration
- Click Create a node with AI
- Describe the specific action you want (e.g., “Search for Python tutorial videos”)
- Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.
| Tool | Description |
|---|
| Search Videos | Search by keyword with filters |
| Get Video Details | Get full video metadata |
| Get Channel Videos | List videos from a channel |
| Get Playlist Videos | Get videos from a playlist |
| Get Channel Details | Get channel stats |
| Get Video Comments | Collect comments |
Credit Costs
| Tool | Credits |
|---|
| Search Videos | 3 per item |
| Get Video Details | 4 per item |
| Get Channel Videos | 3 per item |
| Get Playlist Videos | 3 per item |
| Get Channel Details | 5 per item |
| Get Video Comments | 5 per item |
Example Prompts
Use these with your agent or in the Agent Node:
Search videos:
Find Python pandas tutorials uploaded this year
Get the details for this YouTube video URL
How many subscribers does @mkbhd have?
Get the top 50 comments from this video
Show me the latest 10 videos from @MrBeast
Troubleshooting
| Issue | Solution |
|---|
| Agent not finding the right data | Use exact channel handles or video URLs |
| Action not completing | Check that you’ve authenticated |
| Unexpected results | The agent may chain multiple tools (e.g., finding a channel first, then getting videos). Review the agent’s reasoning to understand its approach. |
| Tool not available | Verify the tool is enabled in your agent’s MCP configuration |
Agents are smart enough to chain multiple API calls together. For example, asking “Get the top comments from MrBeast’s latest video” will find the channel, get recent videos, then fetch comments. If results seem off, check the agent’s step-by-step reasoning.
Need Help?
Use this integration directly in Claude or Cursor. Connect remotely via the YouTube MCP server using your Gumloop credentials. 
