PostOnce home
youtube logo

YouTube + PostOnce

YouTube MCP Server

YouTube MCP server for Claude, ChatGPT, Cursor and Codex. Your AI agent can upload and schedule YouTube videos and Shorts, with the title, description and privacy you choose, through YouTube's official API. There's no scraping, no browser automation and no Google Cloud project to set up.

Connect your agent

Requires a PostOnce account, API access, and your own API key.

MCP server URL
https://postonce.to/mcp
View youtube-mcp on GitHub

What your agent can do on YouTube

Upload and publish a video now

create_upload_url, upload, then create_post with the video in media

Schedule a video for later

create_post with publish_at; PostOnce uploads it at that time

Post a Short

Upload a vertical video (up to 3 minutes). Portrait videos are treated as Shorts; YouTube makes the final call

Set the title and description

platform_options.title (up to 100 characters; defaults to the first line of the content) and platform_options.description (up to 5,000 characters)

Upload as public, unlisted or private

platform_options.privacy (public, unlisted or private; default public)

Pick the category and disclose AI-generated content

platform_options.categoryId (default 22, People & Blogs) and platform_options.ai_generated

Add tags

Put up to 8 hashtags in the description; PostOnce sends them as the video's tags

Save a draft to finish later

create_draft

Check whether a video went out, and get its URL

get_post

Change or cancel a scheduled video

update_post, cancel_post

Post the same video to YouTube and other platforms

Add more targets to create_post (TikTok, Instagram, Facebook, LinkedIn, X, Threads, Pinterest, Bluesky)

Every YouTube post needs one video, up to 768 MB. Uploads through create_upload_url accept MP4, MOV and WebM.

Not supported: community posts, text-only or image posts, playlists, marking videos as made for kids (uploads are always marked not made for kids), setting a custom thumbnail (upload it in YouTube Studio), analytics, reading or replying to comments, and editing or deleting videos after they're published.

Connect YouTube to your agent

You need a PostOnce account with your YouTube account connected. Try it free for 7 days without entering a card.

Claude and ChatGPT

Add a custom connector with this URL and sign in with PostOnce. No API key.

Connector URL
https://postonce.to/mcp

Claude setup · ChatGPT setup

Claude Code

Install the plugin for the connection and the YouTube skills, then set POSTONCE_API_KEY.

Terminal
claude plugin marketplace add postoncehq/plugins
claude plugin install youtube-mcp@postoncehq

Claude Code setup

Cursor, Codex and other clients

Point any MCP client at the URL above over Streamable HTTP with the header Authorization: Bearer and your PostOnce API key. Never paste the key into chat.

Cursor setup · Codex setup · Any MCP client

YouTube skills included

The plugin ships these Agent Skills so your agent knows what works on YouTube before it posts. They work in Claude Code, Codex, Cursor and any client that reads Agent Skills.

  • youtube-title-generator

    Writes 10 title options that lead with the search keyword and make the click, then sets the chosen one as the video title.

  • youtube-description-generator

    Writes a description with the keyword in the first two lines, chapters built from your transcript, links and hashtags, within 5,000 characters.

  • youtube-tag-generator

    Builds a tag set within YouTube's 500-character budget: hashtags for the description (sent as tags) plus a full list to paste into YouTube Studio.

  • youtube-script-generator

    Writes long-form video scripts: a hook for the first 30 seconds, retention beats, a payoff and a call to action.

  • youtube-shorts-script

    Writes vertical Shorts scripts (up to 3 minutes) with the Short's title and description.

  • youtube-thumbnail-maker

    Plans 1280×720 thumbnail concepts and renders one to PNG when your environment can, ready to upload in YouTube Studio.

  • youtube-channel-description

    Writes your channel's About text and keywords for you to paste into YouTube Studio.

  • youtube-content-calendar

    Plans 1–4 weeks of videos and Shorts from your goals or a source, drafts each one, and schedules them once the videos exist.

  • postonce

    Publishing workflow: pick the right account, upload media, schedule, and confirm the post actually went live.

Try these prompts

Try this prompt

Write the title and a description with chapters for this video and schedule it for Thursday at 3pm.

Try this prompt

Upload this vertical clip as a YouTube Short with a title and three hashtags.

Try this prompt

Upload this video as unlisted so I can review it before it goes public.

YouTube MCP questions

Does YouTube have an official MCP server?

This server uses YouTube's official API (the YouTube Data API) through PostOnce. It uploads videos to your channel with the title, description, privacy and category you choose.

Can Claude upload videos to YouTube?

Yes, once it's connected to an MCP server that can publish, like this one. Claude writes the title and description, uploads the video with create_upload_url, then calls create_post.

Is it safe for my YouTube channel?

Yes. Uploads go through YouTube's official API with the permissions you grant when you connect your channel. Many YouTube MCP servers on GitHub drive a logged-in browser or rely on unofficial or scraped endpoints instead, which YouTube's Terms of Service don't allow and which can get channels restricted.

Do I need a Google Cloud project or YouTube API key?

No. PostOnce holds the YouTube API access; you just connect your channel.

Can it post YouTube Shorts?

Yes. Upload a vertical video of up to 3 minutes and it's treated as a Short. YouTube decides the final format from the video itself. The youtube-shorts-script skill writes the script, title and description.

Can it set a custom thumbnail?

No. The youtube-thumbnail-maker skill designs and renders the image, and you upload it in YouTube Studio after the video is up.

Is it free?

The skills are free and MIT-licensed on GitHub. Publishing runs through a PostOnce account, which you can try free for 7 days without entering a card. After that, see pricing.

MCP servers for other platforms

The same connection publishes everywhere PostOnce supports. Each platform has its own skills: LinkedIn MCP, Instagram MCP, TikTok MCP, Facebook MCP, X (Twitter) MCP, Threads MCP, Bluesky MCP, Pinterest MCP.

Let your agent post to YouTube

Connect your agent

Requires a PostOnce account, API access, and your own API key.