# YouTube MCP server

> Connect Claude, ChatGPT or Cursor to YouTube. Your agent schedules Shorts with their title and privacy, answers and hides comments, and reads your views.

Canonical: https://omnisocials.com/youtube-mcp | Channel page: https://omnisocials.com/youtube.md | YouTube API: https://omnisocials.com/youtube-api.md | Pricing: https://omnisocials.com/pricing.md | 14-day free trial: https://app.omnisocials.com/signup

This is the machine-readable version of [omnisocials.com/youtube-mcp](https://omnisocials.com/youtube-mcp), maintained for AI agents. Facts checked against the OmniSocials app on October 16, 2026.

- **Server URL:** https://mcp.omnisocials.com
- **Auth:** OAuth sign-in, or an API key for agents that run on their own
- **Discovery file:** https://omnisocials.com/.well-known/mcp.json
- **Docs:** https://docs.omnisocials.com/mcp-server

- **With your AI agent:** Connect Claude, ChatGPT or any MCP client to YouTube with the OmniSocials MCP server. Your agent schedules Shorts with their title and settings, answers comments and reads your views, through YouTube's official API.
- **With your coding agent:** Claude Code and Codex add the OmniSocials MCP server with one command, and agents that run on their own use an API key. Or call the YouTube API from your own code.

## What your agent does

Ask in plain words. Your agent picks the MCP server's tools and fills in what YouTube asks for.

- **Shorts with their own title.** Up to 100 characters. Leave it out and YouTube gets the caption's first line. (`create_post`, `upload_media`)
- **Every YouTube setting, as fields.** Privacy, made for kids, the AI label, notifications, tags and category. (`create_post`, `update_post`)
- **Answer comments, hide the spam.** Replies post as your channel. New comments arrive within 24 hours. (`reply_to_inbox`, `hide_inbox_comment`)
- **Know what worked.** Views and likes on every Short, and the best time to post the next one. (`get_recent_platform_posts`, `get_best_times`)

## Setup

Connected in a minute. One URL and one sign-in. No API key for chat apps.

1. **Connect YouTube in OmniSocials.** Sign in with Google and pick the channel. Brand channels work too.
2. **Add the server to your agent.** Paste one URL as a custom connector, or run one command.
3. **Sign in and pick a workspace.** OAuth in the browser. Agents that run on their own use an API key.

- **Claude:** Customize > Connectors > Add custom connector > Paste the URL. Claude sends you to OmniSocials to sign in. No API key needed. Guide: https://omnisocials.com/claude
- **Claude Code:** `claude mcp add --transport http omnisocials https://mcp.omnisocials.com`. Then type /mcp in Claude Code and sign in to OmniSocials. Guide: https://omnisocials.com/claude-code
- **Codex:** `codex mcp add omnisocials --url https://mcp.omnisocials.com`. Then run codex mcp login omnisocials to sign in. Guide: https://omnisocials.com/codex
- **API key:** `claude mcp add --transport http omnisocials https://mcp.omnisocials.com --header "Authorization: Bearer YOUR_API_KEY"`. For agents that run on their own. Create the key in Settings, API Keys. Docs: https://docs.omnisocials.com/mcp-server

## Tools

25 tools in 5 groups. Your agent picks them from a plain request.

### Publishing

Shorts, now or on a schedule. Try asking: "Schedule the SDK Short for Thursday at 5 PM, unlisted, with a first comment."

- create_post: Schedule a Short with its title, privacy, tags, category and a first comment.
- create_and_publish_post: Post a Short to YouTube right away.
- update_post: Change the title, settings or time of a scheduled Short.
- upload_media: Upload a video from a URL, up to 1 GB, or from the chat.
- check_media_compatibility: Check a file's size and format against YouTube's rules first.
- retry_post: Publish a failed Short again.

### Comments

Read and answer comments on your videos, hide the rest. Try asking: "Answer the new comments on our latest Short. Hide the spam."

- get_next_unanswered: Get the next comment that needs an answer.
- list_inbox_conversations: List the comments on your channel's videos.
- get_inbox_conversation: Read a video's comments with the video they are on.
- reply_to_inbox: Reply as your channel, right under the comment.
- hide_inbox_comment: Hide a comment and its replies from the video, or show it again.
- mark_inbox_read: Skip a comment that needs no answer.

### Insights

What each Short did, and when to post the next one. Try asking: "Which Short got the most views last month, and when should I post next?"

- get_recent_platform_posts: Your latest Shorts with views, likes and comments, also ones uploaded in YouTube.
- get_post_analytics: The numbers YouTube reports for one Short.
- get_posts_analytics: The numbers for many Shorts at once, to compare them.
- get_account_analytics: Your channel's subscribers, views and video count.
- get_best_times: Your best days and hours from your own Shorts, or industry defaults until you have 15.

### Approvals

Your team or client signs off before a Short goes up. Try asking: "Approve the YouTube Shorts that are waiting for me."

- list_approval_workflows: The review steps a post can go through.
- approve_post: Approve a post that waits for you.
- reject_post: Send a post back with what to change.
- get_post_approval: Where a post stands in its review.

### Accounts and setup

Which channel, which workspace, which hashtags. Try asking: "Switch to the OmniSocials workspace and list the connected channels."

- list_accounts: The accounts connected to the workspace.
- switch_workspace: Work in another workspace.
- create_hashtag_set: Save hashtags to reuse on Shorts.
- create_webhook: Get an event when a post is scheduled, published, approved, rejected or fails.

## FAQ

### What is the YouTube MCP server?

It is the OmniSocials MCP server with your YouTube channel connected. Your AI agent calls its tools to schedule Shorts, answer comments and read your views, through YouTube's official API. The server lives at https://mcp.omnisocials.com, and the same tools post to your other channels too.

### What can my agent set on a Short?

The title, privacy (public, unlisted or private), tags, the category, made for kids, whether to notify subscribers and YouTube's AI-generated label, plus a first comment of up to 10,000 characters. The title is optional: leave it out and YouTube gets the first line of the caption.

It can set a cover image too. YouTube shows it on Shorts only on channels where it has turned custom Shorts thumbnails on; other channels show a frame from the video.

License, languages, embedding and view counts are set in the OmniSocials composer.

### Can it upload long videos?

No. OmniSocials publishes YouTube Shorts of up to 3 minutes, and a longer video is refused before it is scheduled. Long videos, community posts and playlists aren't supported.

### Can it answer and delete YouTube comments?

It can answer and hide them. Replies post as your channel, and a hidden comment leaves the video with its replies until you show it again. YouTube doesn't let apps delete other people's comments, so hiding is how your agent removes spam.

YouTube has no comment webhooks, so new comments reach your agent within 24 hours.

### Which numbers can it read?

Views, likes and comments on every Short, also Shorts you uploaded in YouTube itself, and your channel's subscribers. It suggests your best days and hours to post from your own Shorts once 15 have been analysed, and from industry defaults until then.

### Can it read other channels or get video transcripts?

No. It works with the channel you connected: your Shorts, their comments and your numbers. It doesn't fetch transcripts or scrape other channels.

### How do I connect Claude, ChatGPT or Cursor to YouTube?

Connect YouTube in OmniSocials first: sign in with Google and pick the channel. In Claude, open Customize, then Connectors, click Add, choose Add custom connector and paste https://mcp.omnisocials.com. In ChatGPT, add the same URL as a custom MCP server under Plugins; in Cursor, put it in ~/.cursor/mcp.json. Each one sends you to OmniSocials to sign in and pick a workspace.

### Can an AI agent post to YouTube safely?

Yes. Your agent can send a post through an approval workflow: it waits until a teammate or client approves it, and only then goes out at its time. You can also ask your agent to save drafts, or to show you each post before it schedules it.

### Does the YouTube MCP server need a paid plan?

It needs an active OmniSocials plan or the 14-day free trial; without one, the server turns the connection down. The trial needs a card to start, and the MCP server is part of the one plan, like every other feature.

### How much does OmniSocials cost?

One plan with every feature included: $10 per seat per month billed annually, or $12 billed monthly. Team members and client seats cost the same. Every account starts with a 14-day free trial.

## Related

### Set up your agent

- [Claude](https://omnisocials.com/claude)
- [ChatGPT](https://omnisocials.com/chatgpt)
- [Claude Code](https://omnisocials.com/claude-code)
- [Codex](https://omnisocials.com/codex)
- [Cursor](https://omnisocials.com/cursor)
- [Every agent](https://omnisocials.com/mcp)

### YouTube

- [YouTube scheduler](https://omnisocials.com/youtube)
- [Social inbox](https://omnisocials.com/inbox)
- [Best time to post on YouTube](https://omnisocials.com/best-time-to-post-on-youtube)
- [YouTube video lengths](https://omnisocials.com/youtube-video-lengths)

### For developers

- [MCP server docs](https://docs.omnisocials.com/mcp-server)
- [YouTube API](https://omnisocials.com/youtube-api)
- [CLI](https://omnisocials.com/cli)

## More machine-readable pages

- [YouTube](https://omnisocials.com/youtube.md)
- [YouTube API](https://omnisocials.com/youtube-api.md)
- [All channels](https://omnisocials.com/channels.md)
- [MCP server](https://omnisocials.com/mcp.md)
- [REST API](https://omnisocials.com/api.md)
- [Pricing](https://omnisocials.com/pricing.md)
- [llms.txt](https://omnisocials.com/llms.txt)