vidiq plugin
Official vidIQ plugin for YouTube creators. Find video ideas, trending topics, and keywords; research competitors and outlier videos; audit channel analytics, new uploads, retention, and comments; write and score titles, thumbnails, and scripts; study Instagram Reels and TikTok for YouTube Shorts; prepare, schedule, and publish social posts. 15 guided workflows on vidIQ's hosted MCP server (OAuth, vidIQ account required).
How to install the vidiq plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add vid-io/vidiq-mcp
/plugin install vidiq@vidiq-pluginsWhat's inside vidiq
17 parts read from the plugin's own files.
Agents 1
Call as @agent-vidiq:name- @agent-vidiq:vidiq-mcp.agent
Researches creator opportunities and channel performance with vidIQ MCP, routes requests to the right workflow, and handles media jobs and authorized account changes.
Skills 15
Claude loads it when the task matches- vidiq-channel-audit
Audit an authorized YouTube channel's last 30, 60, or 90 days with private vidIQ analytics (views, watch time, subscribers, format mix, top videos), then prioritize improvements. Use when asked 'analyze, audit, or review my YouTube channel', 'is my channel doing well', 'why are my views or subscribers dropping', or 'monthly channel report'. Whole-channel only; one new upload is vidiq-new-upload-review.
- vidiq-comment-insights
Mine YouTube comments for what viewers ask, want, and object to, with identities removed, then turn it into hooks, titles, FAQs, or script angles, and draft replies. Use when asked 'what do my viewers want', 'summarize or analyze the comments on this video', 'what is my niche's audience asking for', 'does this idea resonate', or 'reply to this comment'.
- vidiq-competitor-watchlist
Find and manage the competitor channels tracked in vidIQ for an authorized YouTube channel, adding or removing channels only after explicit approval. Use when asked 'who are my competitors', 'youtube competitor analysis', 'find channels like mine', 'channels similar to [channel]', or 'clean up my competitor list'.
- vidiq-get-started
Set up, verify, or troubleshoot vidIQ MCP and pick a first workflow. Use when asked to connect vidIQ, a YouTube channel, or a social account, 'is vidIQ connected', 'which channel is linked', 'which account is linked', 'check my credits', or when vidIQ tools are missing, a call returns 401, 403, or verification errors, credits run out, or a thumbnail, watch, or script job is stuck. Not for creator research.
- vidiq-new-upload-review
Triage a just-published YouTube video or Short against the channel's own curve at the same publication age and decide whether to wait, investigate, or change packaging. Use when a creator says 'I just uploaded', 'my new video is not getting views or impressions', 'is my latest video flopping', 'my Shorts are getting 0 views', or 'should I change the thumbnail or title'.
- vidiq-next-video-planner
Rank what an authorized YouTube creator should publish next from their own analytics plus live search demand, audience requests, trends, and competitor gaps. Use when asked 'what should my next video be', 'what should I post on YouTube to grow', or 'rank these ideas for my channel'. Needs the creator's own channel; for ideas from breakout videos in any niche use vidiq-video-ideas.
- vidiq-packaging-studio
Write, score, compare, and improve YouTube titles and thumbnails, and optionally a script, for an idea, script, reference video, or underperforming video. Use whenever a creator asks for titles or thumbnails, even a quick list; vidIQ scoring improves them. Triggers include 'title ideas', 'rewrite my title', 'thumbnail ideas', 'make or refine a thumbnail', 'which title is better', 'A/B test these titles or thumbnails', 'why didn't this video get clicks', or 'write a script for this video'.
- vidiq-publishing
Prepare and adapt supplied content for YouTube, Instagram, TikTok, X, and Facebook Pages; save drafts, publish or schedule approved versions, and track each destination. Use when asked 'post this everywhere', 'publish a Reel', 'upload to YouTube', 'tweet this', 'schedule these posts', 'change my draft', 'what is scheduled', or 'did my post go out'. For changes to a video already on YouTube, use vidiq-video-metadata.
- vidiq-retention-analysis
Find where and why viewers leave an authorized YouTube video using vidIQ audience-retention analytics, the transcript, watched scenes when available, and comments. Use when asked about 'audience retention', 'watch time', 'where people drop off', 'my intro or hook loses viewers', or 'average view duration is low', or for pacing and structure advice on one video.
- vidiq-shorts-inspiration
Find original YouTube Shorts ideas by studying what is breaking out on Instagram Reels and TikTok, then adapting the hook, pacing, format, and payoff. Use when asked for 'Shorts ideas', 'how to go viral on Shorts', 'viral TikTok or Reels formats I can use', 'what's working on TikTok in [niche]', or 'how are my Reels doing'.
- vidiq-trend-radar
Judge YouTube trends by urgency, durability, saturation, and accessibility to smaller channels using live vidIQ data. Use when asked 'what's trending on YouTube today', 'trending topics in [niche] this week', 'is this trend worth a video', or 'should I jump on this now or is it too late'. Classifies topics as urgent, durable, mature, or misleading.
- vidiq-video-breakdown
Analyze any public YouTube video from a URL or ID, covering view history and velocity, title and thumbnail changes, transcript hooks and structure, comment themes, similar videos, and estimated earnings. Use when asked 'analyze this video', 'why did this video go viral', 'break down this competitor's video', 'summarize this YouTube video', or 'how much did this video earn'. No channel authorization needed.
- vidiq-video-ideas
Find original YouTube video ideas from outlier videos overperforming right now in the creator's niche and adjacent niches. Use when asked for 'video ideas', 'content ideas', 'what's working in my niche', 'videos breaking out', or '10 ideas for a [niche] channel'. Returns concept cards for packaging. For a ranked choice based on the creator's own analytics use vidiq-next-video-planner.
- vidiq-video-metadata
Apply approved changes to a YouTube video you own through vidIQ (title, description, tags, chapters, privacy, scheduled publish time, or thumbnail), with a snapshot and readback. Use when asked 'update my video title', 'change the description', 'add these tags', 'add chapters', 'schedule this video', or 'swap the thumbnail'. Requires owner authorization and explicit approval of the exact change.
- vidiq-youtube-seo
Research YouTube keywords and search demand with vidIQ, then draft tags, a description, and title angles. Use when asked 'youtube keyword research', 'search volume for [topic]', 'youtube seo', 'tags for my video', or 'write my video description'. Text output only; applying changes to a video belongs to vidiq-video-metadata.
MCP servers 1
Starts with the plugin- vidiqhttp
https://mcp.vidiq.com/mcp
Using vidiq in Claude Code
Ask for an agent by name:
@agent-vidiq:vidiq-mcp.agentSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update vidiq@vidiq-plugins
- Refresh the marketplace
- /plugin marketplace update vidiq-plugins
- Turn it off for now
- /plugin disable vidiq@vidiq-plugins
- Remove it
- /plugin uninstall vidiq@vidiq-plugins
Skills in vidiq
- vidiq-channel-auditvid-io/vidiq-mcp
Audit an authorized YouTube channel's last 30, 60, or 90 days with private vidIQ analytics (views, watch time, subscribers, format mix, top videos), then prioritize improvements. Use when asked 'analyze, audit, or review my YouTube channel', 'is my channel doing well', 'why are my views or subscribers dropping', or 'monthly channel report'. Whole-channel only; one new upload is vidiq-new-upload-review.
3 files9stars - vidiq-comment-insightsvid-io/vidiq-mcp
Mine YouTube comments for what viewers ask, want, and object to, with identities removed, then turn it into hooks, titles, FAQs, or script angles, and draft replies. Use when asked 'what do my viewers want', 'summarize or analyze the comments on this video', 'what is my niche's audience asking for', 'does this idea resonate', or 'reply to this comment'.
5 files9stars - vidiq-competitor-watchlistvid-io/vidiq-mcp
Find and manage the competitor channels tracked in vidIQ for an authorized YouTube channel, adding or removing channels only after explicit approval. Use when asked 'who are my competitors', 'youtube competitor analysis', 'find channels like mine', 'channels similar to [channel]', or 'clean up my competitor list'.
4 files9stars - vidiq-get-startedvid-io/vidiq-mcp
Set up, verify, or troubleshoot vidIQ MCP and pick a first workflow. Use when asked to connect vidIQ, a YouTube channel, or a social account, 'is vidIQ connected', 'which channel is linked', 'which account is linked', 'check my credits', or when vidIQ tools are missing, a call returns 401, 403, or verification errors, credits run out, or a thumbnail, watch, or script job is stuck. Not for creator research.
5 files9stars - vidiq-new-upload-reviewvid-io/vidiq-mcp
Triage a just-published YouTube video or Short against the channel's own curve at the same publication age and decide whether to wait, investigate, or change packaging. Use when a creator says 'I just uploaded', 'my new video is not getting views or impressions', 'is my latest video flopping', 'my Shorts are getting 0 views', or 'should I change the thumbnail or title'.
3 files9stars - vidiq-next-video-plannervid-io/vidiq-mcp
Rank what an authorized YouTube creator should publish next from their own analytics plus live search demand, audience requests, trends, and competitor gaps. Use when asked 'what should my next video be', 'what should I post on YouTube to grow', or 'rank these ideas for my channel'. Needs the creator's own channel; for ideas from breakout videos in any niche use vidiq-video-ideas.
5 files9stars - vidiq-packaging-studiovid-io/vidiq-mcp
Write, score, compare, and improve YouTube titles and thumbnails, and optionally a script, for an idea, script, reference video, or underperforming video. Use whenever a creator asks for titles or thumbnails, even a quick list; vidIQ scoring improves them. Triggers include 'title ideas', 'rewrite my title', 'thumbnail ideas', 'make or refine a thumbnail', 'which title is better', 'A/B test these titles or thumbnails', 'why didn't this video get clicks', or 'write a script for this video'.
7 files9stars - vidiq-publishingvid-io/vidiq-mcp
Prepare and adapt supplied content for YouTube, Instagram, TikTok, X, and Facebook Pages; save drafts, publish or schedule approved versions, and track each destination. Use when asked 'post this everywhere', 'publish a Reel', 'upload to YouTube', 'tweet this', 'schedule these posts', 'change my draft', 'what is scheduled', or 'did my post go out'. For changes to a video already on YouTube, use vidiq-video-metadata.
6 files9stars - vidiq-retention-analysisvid-io/vidiq-mcp
Find where and why viewers leave an authorized YouTube video using vidIQ audience-retention analytics, the transcript, watched scenes when available, and comments. Use when asked about 'audience retention', 'watch time', 'where people drop off', 'my intro or hook loses viewers', or 'average view duration is low', or for pacing and structure advice on one video.
4 files9stars - vidiq-shorts-inspirationvid-io/vidiq-mcp
Find original YouTube Shorts ideas by studying what is breaking out on Instagram Reels and TikTok, then adapting the hook, pacing, format, and payoff. Use when asked for 'Shorts ideas', 'how to go viral on Shorts', 'viral TikTok or Reels formats I can use', 'what's working on TikTok in [niche]', or 'how are my Reels doing'.
5 files9stars - vidiq-trend-radarvid-io/vidiq-mcp
Judge YouTube trends by urgency, durability, saturation, and accessibility to smaller channels using live vidIQ data. Use when asked 'what's trending on YouTube today', 'trending topics in [niche] this week', 'is this trend worth a video', or 'should I jump on this now or is it too late'. Classifies topics as urgent, durable, mature, or misleading.
4 files9stars - vidiq-video-breakdownvid-io/vidiq-mcp
Analyze any public YouTube video from a URL or ID, covering view history and velocity, title and thumbnail changes, transcript hooks and structure, comment themes, similar videos, and estimated earnings. Use when asked 'analyze this video', 'why did this video go viral', 'break down this competitor's video', 'summarize this YouTube video', or 'how much did this video earn'. No channel authorization needed.
5 files9stars - vidiq-video-ideasvid-io/vidiq-mcp
Find original YouTube video ideas from outlier videos overperforming right now in the creator's niche and adjacent niches. Use when asked for 'video ideas', 'content ideas', 'what's working in my niche', 'videos breaking out', or '10 ideas for a [niche] channel'. Returns concept cards for packaging. For a ranked choice based on the creator's own analytics use vidiq-next-video-planner.
4 files9stars - vidiq-video-metadatavid-io/vidiq-mcp
Apply approved changes to a YouTube video you own through vidIQ (title, description, tags, chapters, privacy, scheduled publish time, or thumbnail), with a snapshot and readback. Use when asked 'update my video title', 'change the description', 'add these tags', 'add chapters', 'schedule this video', or 'swap the thumbnail'. Requires owner authorization and explicit approval of the exact change.
4 files9stars - vidiq-youtube-seovid-io/vidiq-mcp
Research YouTube keywords and search demand with vidIQ, then draft tags, a description, and title angles. Use when asked 'youtube keyword research', 'search volume for [topic]', 'youtube seo', 'tags for my video', or 'write my video description'. Text output only; applying changes to a video belongs to vidiq-video-metadata.
4 files9stars
vidiq plugin questions
How do I install the vidiq plugin?
In Claude Code run /plugin marketplace add vid-io/vidiq-mcp, then /plugin install vidiq@vidiq-plugins.
What does the vidiq plugin include?
vidiq bundles 1 agent, 15 skills, MCP servers.
Which agents come with vidiq?
vidiq-mcp.agent. Call one with @agent-vidiq:vidiq-mcp.agent.
How do I update or remove the vidiq plugin?
Update it with claude plugin update vidiq@vidiq-plugins in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall vidiq@vidiq-plugins.
What license is the vidiq plugin under?
Apache-2.0, as stated in the plugin's manifest.