Hermoso is a marketing MCP server: 906+ tools over one OAuth’d endpoint that let an agent research the ads already running in a market, generate finished image and video ads, publish them, and build the paid campaigns behind them. Grok Bot reaches all of it through one connection. This page covers one slice of that: what Grok Bot can actually do on YouTube, and what YouTube will not let it do.
Connect Hermoso to Grok Bot
- Fastest: add the Hermoso Marketing Bot template. Open the template and add it to Grok Bot. It arrives wired to Hermoso but with no key, because templates never carry secrets, so it asks for one: create a key under MCP & CLI → Terminal & API keys and paste it into the Bot’s chat. A key carries real spend authority, so treat it like a password.
- Or sign in from the Bot’s own terminal. Every Bot gets a browser, a filesystem and a shell, so the keyless install works there too:
Thenpm install -g hermoso && hermoso auth loginhermosocommand is then available to the Bot with nothing pasted into a config file. Settings → Plugins is a catalog of pre-built connectors that does not list Hermoso, so the template and the terminal are the ways in today. - Using Grok Build instead? xAI’s terminal coding agent is a separate product with its own setup: see Hermoso in Grok Build.
- Ask a Bot for something. “Pull my three closest competitors’ longest-running ads and remix the best hook into a 9:16 video,” or “post this render to the channel.” The agent picks the tools; you approve the spend.
Hermoso is not affiliated with or endorsed by xAI and does not claim to be. The Hermoso Marketing Bot template is published by Hermoso; the same steps are in the app under MCP & CLI, on the Grok Bot tab of the agent setup.
Then connect YouTube itself, once, under Settings → Connectors in Hermoso. That is an OAuth consent screen, so it is the one step that needs a browser. Everything after it is a tool call.
The YouTube tools Grok Bot gets
post_to_youtube: uploads a finished video with a title, a description of up to 5,000 characters, up to 30 tags, and a privacy setting.schedule_post: queues the upload, and carries the description and tags through with it.set_youtube_thumbnail: puts a designed thumbnail on the upload. It is the single biggest lever on click-through, and YouTube otherwise picks a frame more or less at random.make_thumbnail: generates that thumbnail in the first place.update_youtube_video / list_youtube_videos: edit an upload’s metadata, or list your own uploads, including unlisted and private ones a public search cannot see.youtube_video_insights / youtube_channel: views, watch time, average view percentage and subscribers gained.list_youtube_comments / reply_to_youtube_comment: read and answer comments as the channel.
The unit really is a video: post_to_youtube takes a videoUrl and there is no image path at all. Two smaller gates worth knowing before an automated upload: a Google project that has not been verified has videos.insert locked to private regardless of what you ask for, and custom thumbnails need a phone-verified channel.
YouTube limits worth knowing before you automate anything
| Text | A YouTube title is capped at 100 characters, and a scheduled item’s text becomes the title. The description is a separate field of up to 5,000 characters, carrying up to 30 tags. It is enforced when the post is created or queued, so an overlong post is refused while you are still there to fix it instead of being silently cut on the way out. |
|---|---|
| Visibility | Public, unlisted or private. There is no Studio draft: “YouTube’s API can upload as public, unlisted or private, but it cannot create a Studio draft”, so unlisted is the closest thing to a review state, and it is what an immediate post defaults to so an ad-ready upload is not accidentally public. |
| Carousel | Refused, by name. “YouTube’s unit is a video, not a set of stills. Turn the slides into a video (Hermoso can stitch them) and post that instead, or drop YouTube from this post.” Hermoso did not invent that limit to avoid work; it is simply what YouTube is. The refusal comes at enqueue, with the way forward attached, instead of a silently posted first slide. |
| Which account | None. YouTube publishes to the connected channel. |
Try it in Grok Bot
Ask for it in ordinary language. These are plain sentences, not a DSL:
“For every film that finishes rendering, write a title under 100 characters and a full description with links, generate a thumbnail, upload it unlisted, and send me the link.”
That walks make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights. Approval is Grok Bot’s setting rather than ours, and the shared machine is the reason to think about it: isolation is per user, not per Bot, so anything one Bot connects, every Bot on that machine can reach.
Grok Bot on YouTube: the part that bites
Say description and tags explicitly in the job. If you only give a caption it becomes the 100-character title and the 5,000-character description stays empty, which is where the links, the CTA and everything YouTube search reads were supposed to go. It is unrecoverable at the point anyone notices, and an agent that uploads on its own will make the same omission every time until you fix the instruction.
For a long unattended run the hermoso CLI is the cheaper path: the agent shells out per command instead of carrying an 906+ tool manifest through every turn of a job that might run for days.
Research YouTube before you post
search_youtube searches the public YouTube index. That is a different question from “what have I uploaded”, and list_youtube_videos is the tool for that one. For a competitor’s film, analyze_video returns the voiceover, the on-screen text and the beat list with timestamps, which is what you actually want before rebuilding a hook.
The paid half
Hermoso’s Google Ads tools build search, display and Performance Max campaigns (the whole tree in one atomic operation, read back from Google before your agent narrates it), plus Keyword Planner volumes, conversion actions, and sitelinks and callouts created and attached. There is no YouTube video-campaign builder, and it would be wrong to imply one; a YouTube video asset can be uploaded and attached, but the campaign types Hermoso creates are search, display and Performance Max.
What Grok Bot cannot do on its own
An agent with a budget is only useful if the blast radius is bounded, so the fence is in the server rather than in a prompt. Every ad campaign, ad set, ad group and ad is created paused, and the status switches that arm real money refuse to run without an explicit confirmation flag. Every render is quoted first (hermoso_capabilities publishes each model’s exact credit cost before anything spends). Credits are reserved before the first provider call and settled at the exact cost afterwards, so a failed dispatch refunds rather than leaving you billed for nothing. Deletes are confirm-gated too, and every campaign tree is read back from the ad platform before your agent tells you what it built.
One step is deliberately not headless: linking an account is an OAuth consent screen, so you connect the channel once in a browser. Everything after that is a tool call.
The rest of the matrix
From Grok Bot, post to: Facebook · Instagram · Threads · TikTok · X · LinkedIn · Pinterest · Bluesky · Telegram. Or see everything Grok Bot can publish to.
Post to YouTube from: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
Frequently asked questions
Can Grok Bot post to YouTube?
Yes, through Hermoso's MCP server. Add the Hermoso Marketing Bot template from x.ai/bot/THQqogUKuhn1whWU0hrmb, which arrives wired to Hermoso and asks for an API key you create under MCP & CLI, Terminal & API keys. Or run npm install -g hermoso && hermoso auth login in the Bot's own terminal, which stores the credential with nothing pasted. Grok Bot then has 906+ tools, including the ones that publish to YouTube, plus the ones that research the ads already running in your market and render the creative in the first place.
How do I connect YouTube to Grok Bot?
Two steps, once each. Add the Hermoso Marketing Bot template from x.ai/bot/THQqogUKuhn1whWU0hrmb, which arrives wired to Hermoso and asks for an API key you create under MCP & CLI, Terminal & API keys. Or run npm install -g hermoso && hermoso auth login in the Bot's own terminal, which stores the credential with nothing pasted. Then connect YouTube inside Hermoso under Settings → Connectors, which is an OAuth consent screen in a browser. After that Grok Bot publishes to YouTube as an ordinary tool call.
Does Grok Bot need my YouTube password?
No. You connect YouTube to Hermoso once through an OAuth consent screen in a browser, and Grok Bot then reaches it as a tool call. Linking an account is the one step that is not headless; nothing after it needs a password, and no credential is ever handed to the model.
Can Grok Bot research YouTube before it posts?
Yes. search_youtube searches the public YouTube index, list_youtube_videos reads your own uploads including unlisted ones, and analyze_video returns a competitor film’s voiceover, on-screen text and beat list with timestamps.
Can Grok Bot post a carousel to YouTube?
No, and the refusal says why rather than saying "unsupported": YouTube’s unit is a video, not a set of stills. Hermoso can stitch the slides into a video and post that instead. Grok Bot calls the same publish tool either way, and a channel that cannot carry a carousel is refused with the real reason attached.
Can Grok Bot run YouTube ads as well as posting?
Hermoso builds Google Ads search, display and Performance Max campaigns, with Keyword Planner volumes and conversion actions. There is no YouTube video-campaign builder, and we do not imply one.
Related
The long version, with the setup and what it did in practice: run your marketing with a Grok bot and autonomous marketing with a Grok bot.
The same bot on other channels: X, Instagram, TikTok, Facebook, LinkedIn, Threads and Pinterest.
Start free with 30 credits at signup and 250+ more to earn. Every feature is on every plan. Credits are spent only on AI models and Ad Spy research; posting, scheduling, ads management and analytics are free.
Start free → See pricing