Does vidIQ work in the Gemini app?

This page covers Gemini CLI, which supports remote MCP servers. vidIQ works with any AI tool that can add a remote MCP server; if yours can, add the same server URL.

Does vidIQ in Gemini CLI use credits?

Yes. vidIQ works on every plan, including Free, and each tool call draws from the credits included in your plan. Most research tools cost 5 credits per call. Ask "How many vidIQ credits do I have left?" to check your balance.

Gemini CLI MCP Server

Give Gemini CLI real YouTube data

Q: Do I need a vidIQ API key for Gemini CLI?

No. Gemini CLI signs in to vidIQ in the browser. If you only need read-only access, create an API key in vidIQ Account Settings and send it as an Authorization: Bearer header instead of enabling oauth.

Add vidIQ to Gemini CLI as a remote MCP server and research channels, keywords, competitors, trends, and transcripts from your terminal.

Connect vidIQ to Gemini CLI

How to connect vidIQ to Gemini CLI

1Open ~/.gemini/settings.json (create it if it does not exist) and add the vidiq block shown here under mcpServers.
2Start Gemini CLI and run /mcp auth vidiq. Sign in with your vidIQ account in the browser and grant access.
3Run /mcp to confirm vidIQ is connected and its tools are listed.

~/.gemini/settings.json

{
  "mcpServers": {
    "vidiq": {
      "httpUrl": "https://mcp.vidiq.com/mcp",
      "oauth": { "enabled": true }
    }
  }
}

Only need read-only access? Create an API key in vidIQ Account Settings and replace the oauth line with "headers": { "Authorization": "Bearer YOUR_API_KEY" }.

vidIQ MCP Prompt Library

Ready-to-Use YouTube Prompts for Gemini CLI

Ready-to-use prompts. Paste directly into your AI tool.

vidIQ MCP Credits & Tools

52 tools and counting

46 core tools below, plus 6 free utility tools

keyword_research
Find keywords your competitors are sleeping on
outliers
Spot videos that blew up for a reason
generate_clips
Turn a long video into vertical clips
generate_thumbnail
Generate a thumbnail from a prompt
generate_titles
Generate high-CTR title ideas
subscriber_insights
Find your best time to post and who else your fans watch
video_transcript
Read any video without watching it
trending_videos
See what formats are blowing up right now

Plus 6 free utility tools: credits balance, your connected channels, async job tracking, voice library, and feedback. Tool calls draw from your vidIQ plan’s shared credit pool.

vidIQ in Gemini CLI: common questions

Add a vidiq entry under mcpServers in ~/.gemini/settings.json with httpUrl set to https://mcp.vidiq.com/mcp and oauth enabled, then run /mcp auth vidiq in Gemini CLI and sign in with your vidIQ account.