vidiq-mcp
Official vidIQ MCP plugin. Grow on YouTube, Instagram & TikTok.
Install / Use
claude mcp add vid-io -- npx -y github:vid-io/vidiq-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Data & AnalyticsSupported Platforms
Our assessment of vidiq-mcp
vidiq-mcp scores 81/100 on our quality scale, 514th of 604 Data & Analytics skills we index.
Its MCP Server is 30 KB long, well organised into 25 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 3 days ago, so vidiq-mcp is actively maintained.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
vidiq-mcp compared with similar skills
All 4 of these similar skills score higher than vidiq-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| vidiq-mcp (this skill)by vid-io | 81 | 10 | 3d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install vidiq-mcp?
- Run
claude mcp add vid-io -- npx -y github:vid-io/vidiq-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does vidiq-mcp work with?
- It is written for Claude Code, Claude Desktop, Cursor, GitHub Copilot, Gemini CLI and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is vidiq-mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is vidiq-mcp still maintained?
- The repository was last updated 3 days ago, so vidiq-mcp is actively maintained.
Skill content
View source on GitHubvidIQ YouTube MCP Server
vidIQ's YouTube MCP server for ChatGPT, Claude, Cursor, and other MCP clients, with a creator workflow plugin.
vidIQ MCP is a hosted YouTube MCP server. It connects ChatGPT, Claude,
Codex, Cursor, Gemini CLI, GitHub Copilot, and other MCP-compatible AI assistants to live vidIQ data:
YouTube channel analytics, keyword research, outlier and trending videos, comments, transcripts,
competitor channels, and title and thumbnail scoring. Study public Instagram and TikTok short-form
content when those tools are exposed by the connected account, and analyze private YouTube
performance for channels connected to your vidIQ account. vidIQ runs the server at
https://mcp.vidiq.com/mcp, so you don't host anything or set up a YouTube Data API key or Google
Cloud project.
The workflow plugin turns that data into better content decisions with guided creator playbooks.
Connect in ChatGPT · Connect in Claude.ai · Connect in Muse · Install the workflow plugin · Setup guide
[!NOTE] vidIQ hosts the MCP service. This repository distributes connection metadata and a creator workflow pack for compatible AI clients.
vidIQ MCP can access data available to the vidIQ account and channels you authorize. Tool results are returned to the AI client you choose, whose privacy practices also apply. See the vidIQ Privacy Policy and the disconnect instructions.
What you can do
Use live vidIQ data to decide what to make next and understand how your content performs:
- Discover video ideas, emerging trends, and opportunities in your niche (
vidiq_outliers,vidiq_trending_videos,vidiq_similar_videos). - Research keywords and search demand, then draft tags and descriptions (YouTube SEO)
(
vidiq_keyword_research). - Research competitors, successful videos, and the questions viewers ask in comments
(
vidiq_channel_search,vidiq_similar_channels,vidiq_comment_insights). - Analyze any public video to learn why it performed (
vidiq_video_stats,vidiq_video_transcript,vidiq_video_watch). - Review your channel's performance, new uploads, and audience retention
(
vidiq_channel_analytics,vidiq_channel_performance_trends). - Improve titles and thumbnails with research, scoring, and creative workflows, then apply approved
changes to videos you own (
vidiq_score_title,vidiq_generate_thumbnail,vidiq_update_video). - Study public Instagram and TikTok content for patterns to adapt to YouTube Shorts
(
vidiq_instagram_tiktok_outlier_search). - Prepare content for YouTube, Instagram, TikTok, X, and Facebook Pages, then publish or schedule
the exact versions you approve (
vidiq_social_post_draft_create,vidiq_social_post_publish). - Draft comment replies, generate chapters, estimate earnings, and save research to
bookmarks (
vidiq_generate_comment_replies,vidiq_generate_video_chapters,vidiq_video_earnings_estimate,vidiq_bookmarks_save).
See Tools the workflows use for the full tool list.
YouTube research covers public channels and videos; private analytics require a channel authorized in your vidIQ account. Instagram and TikTok research depends on the tools available to your connected account. Coverage varies by tool, format, language, and market; ask the assistant to check availability before starting research.
Connect vidIQ
Step-by-step guides for each client are on vidiq.com: ChatGPT, Claude, Muse, Cursor, Codex, Gemini CLI, Perplexity, Grok, and OpenClaw.
ChatGPT
Install the official vidIQ app directly in ChatGPT:
- Open the app listing and select Install or Try it.
- Sign in with the vidIQ account you want to use. It does not need to share an email address with your ChatGPT account.
- Grant access. The hosted vidIQ tools are then available in your ChatGPT conversations.
If the listing does not open directly, find vidIQ in the ChatGPT plugin directory.
Try asking:
What topics are trending in my niche that I have not covered yet?
The ChatGPT plugin connects the hosted vidIQ tools, and current releases also bundle the creator
workflows from this repository as skills; new workflows arrive with the next plugin release. Type
@vidIQ at the start of a prompt to use it explicitly, or describe the outcome you want and ChatGPT
picks the matching skill.
Claude.ai
Add vidIQ as a custom connector in Claude.ai:
- Open Customize → Connectors.
- Select Add custom connector.
- Name the connector vidIQ and enter
https://mcp.vidiq.com/mcp. - Add the connector, then authorize the vidIQ account you want to use.
- In a conversation, open + → Connectors and enable vidIQ when needed.
For Team and Enterprise organizations, an organization owner must add the connector before members can use it.
The Claude.ai connector makes the hosted vidIQ tools available in conversations. It does not install the workflow skills from this repository; those require a compatible plugin client such as Claude Code.
Muse
Add vidIQ from the Muse connector directory, when it is available in your Muse connectors:
- Open the vidIQ connector in Muse, or in Muse open Settings → Connectors and search for vidIQ.
- Select Connect, review the information, then select Continue.
- Sign in with the vidIQ account you want to use and authorize the connection.
- In a chat, start your prompt with "Use vidIQ to…" so Muse uses live data.
The Muse connector makes the hosted vidIQ tools available in conversations. It does not install the workflow skills from this repository. See the Muse guide for prompts to try.
Workflow plugin
Install the vidIQ workflow plugin to connect your AI client to vidIQ's hosted tools and add guided creator workflows and safe recovery for long-running jobs. Clients with bundled-agent support can also load the vidIQ specialist to select the right workflow. Shared rules cover scope, evidence quality, and permissions; discovery, production, and job-recovery guidance loads when relevant to the request. The capabilities and prices shown in your connected client apply.
Claude Code
Run these commands in your terminal:
claude plugin marketplace add vid-io/vidiq-mcp
claude plugin install vidiq@vidiq-plugins
This installs the plugin for your user account across projects. Restart Claude Code, then run
/mcp and authenticate the vidIQ server when prompted. See the
Claude Code plugin guide for installation
scopes and updates.
Invoke workflows as /vidiq:vidiq-get-started or /vidiq:vidiq-packaging-studio.
Version 0.1.3 restores the vidiq- skill prefix. Version 0.1.4 renames Channel Review to
Channel Audit; invoke it as /vidiq:vidiq-channel-audit. Connection diagnostics and job
recovery are part of Get Started. Version 0.2.0 adds /vidiq:vidiq-youtube-seo,
/vidiq:vidiq-video-breakdown, and /vidiq:vidiq-video-metadata. Version 0.2.1 wires the newer
hosted tools: niche-wide comment insights and reply drafts, chapters, title and thumbnail change
history, own-video listing, earnings estimates, bookmarks, and YouTube channel connection. It also
folds Packaging Comparison into Packaging Studio as a compare mode and shortens every skill
description so the full list fits in Codex and ChatGPT.
Grok Build
The command below installs vidIQ directly from GitHub. It works without a Grok marketplace listing. Install Grok Build, then run:
grok plugin install vid-io/vidiq-mcp --trust
Start a new session with grok and sign in to Grok if prompted. To connect your vidIQ account:
- Open
/mcpsand expand Plugin: vidiq. - Select vidiq and press
ito authenticate. - Complete vidIQ sign-in and authorization in your browser.
- Return to Grok and run
/vidiq-get-started.
If the connection fails, run grok mcp doctor vidiq in your terminal. See the
Grok MCP guide for connection settings and help.
OpenClaw
You need OpenClaw with MCP bundle support and a vidIQ account. Install from ClawHub:
openclaw plugins install clawhub:@vidiq/vidiq
openclaw plugins inspect vidiq
openclaw skills list
Review the requested capabilities before accepting. Confirm that inspection lists skills and
mcpServers, and that the skill list includes the 15 vidiq- workflows.
Register the server for OpenClaw's login command, then authorize your vidIQ account:
openclaw mcp set vidiq '{"url":"https://mcp.vidiq.com/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login vidiq
openclaw mcp doctor vidiq --probe
Complete sign-in in the browser and start your OpenClaw Gateway if it is stopped. In a new agent conversation, ask: “Check my vidIQ connection, authorized channels, and credit balance.” All agents using this setup share the connected vidIQ account. Only enable it for people you trust with that account; credentials stay in OpenClaw's credential store.
If tools are missing, check the plugin and tool policy; the minimal profile or a denial of
bundle-mcp can hide them. See the OpenClaw MCP guide
and bundle documentation for host requirements.
Switch accounts or remove vidIQ
Switch accounts with openclaw mcp logout vidiq, then openclaw mcp login vidiq.
Sign in with the intended account in the browser and confirm the authorized channels.
To remove the integration:
openclaw mcp logout vidiq
openclaw mcp unset vidiq
openclaw plugins uninstall vidiq
Removing only the saved server leaves the bundle's server definition available.
Hermes Agent
With a current Hermes version supporting portable plugins, run:
hermes plugins install vid-io/vidiq-mcp --no-enable
hermes plugins enable vidiq
hermes mcp add vidiq --url https://mcp.vidiq.com/mcp --auth oauth
Complete vidIQ authorization in your browser, then start a new session and ask Hermes to use vidIQ Get Started. The plugin installs all 15 workflows; the separate MCP connection provides the live tools. A vidIQ account is required, and hosted tools may consume credits.
Check the connection with hermes mcp test vidiq. If already configured, sign in again or switch
accounts with hermes mcp login vidiq, then confirm the authorized channels. See the
Hermes MCP guide for help.
To update, run hermes plugins update vidiq and start a new session. To remove vidIQ, run
hermes plugins disable vidiq, hermes plugins remove vidiq, and hermes mcp remove vidiq.
Removing only the plugin leaves the MCP connection active.
Local preview
For local preview, clone or download this repository and follow your client's local-plugin flow. Install from a clean clone or archive, and keep ignored files, local credentials, and other local-only files out of the package.
| Client |
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
