SkillAgentSearch skills...

vidiq-mcp

Official vidIQ MCP plugin. Grow on YouTube, Instagram & TikTok.

Install / Use

claude mcp add vid-io -- npx -y github:vid-io/vidiq-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

81/100

Supported Platforms

Claude Code
Claude Desktop
Cursor
GitHub Copilot
Gemini CLI
OpenAI Codex

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.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
4/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
vidiq-mcp (this skill)by vid-io81103d agoMCP Server
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.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.

vidIQ 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:

  1. Open the app listing and select Install or Try it.
  2. Sign in with the vidIQ account you want to use. It does not need to share an email address with your ChatGPT account.
  3. 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:

  1. Open Customize → Connectors.
  2. Select Add custom connector.
  3. Name the connector vidIQ and enter https://mcp.vidiq.com/mcp.
  4. Add the connector, then authorize the vidIQ account you want to use.
  5. 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:

  1. Open the vidIQ connector in Muse, or in Muse open Settings → Connectors and search for vidIQ.
  2. Select Connect, review the information, then select Continue.
  3. Sign in with the vidIQ account you want to use and authorize the connection.
  4. 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:

  1. Open /mcps and expand Plugin: vidiq.
  2. Select vidiq and press i to authenticate.
  3. Complete vidIQ sign-in and authorization in your browser.
  4. 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

View on GitHub
GitHub Stars10
CategoryData
Updated3d ago
Forks1

Languages

Python

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low1 info