Skip to content

YouTube MCP server

Let Claude, Codex or Cursor schedule YouTube videos and Shorts with titles, cross-post to five more platforms and read views over MCP.

What is the aghost YouTube MCP server?

aghost's YouTube MCP server lets Claude, Codex, Cursor or another MCP client schedule YouTube videos and Shorts with a title and description, edit them before they publish and read views and engagement. One request can post the same video to Instagram, Facebook, LinkedIn, X and Threads, each with its own caption.

Connect it at https://aghost.app/api/mcp. It’s included on every plan.

What your agent can do

  • Schedule a post here and on your other channels in one request, with its own caption for each
  • Edit, reschedule or cancel a post before it publishes
  • Read account and post analytics for the last 7, 30 or 90 days
  • Suggest posting times from the account's history

What it can post

  • One video per post, with a title of up to 100 characters
  • Shorts: vertical or square videos of up to 3 minutes

JPEG or PNG photos up to 20 MB and MP4 or MOV videos up to 300 MB, scheduled at least 5 minutes ahead.

To connect: The YouTube channel of the Google account you choose. A social set holds one channel.

Limits and metrics

Description
5,000 characters
Title
100 characters
Media
One video
Text-only posts
No
Metrics
views, likes, comments, shares

Every copy is checked against these limits before anything is scheduled.

Connect once. Then ask.

Choose a plan and connect your channels in Settings → Channels first. Your agent connects in one of two ways.

Sign in

Apps with MCP sign-in

In Claude, open Customize → Connectors → Add custom connector and paste the URL. Leave the client ID and secret empty, then choose Allow in aghost.

https://aghost.app/api/mcp
API key

Claude Code, Codex, Cursor and others

Create a key in Settings → API and keep it in your agent’s environment or secret store. The setup skill has each client’s steps.

{
  "mcpServers": {
    "aghost": {
      "type": "http",
      "url": "https://aghost.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ask your agent about YouTube

Supply your own media and links, then review the result in aghost. Scheduled posts publish at their time.

  • Turn a reel into a Short

    “Schedule this reel as a YouTube Short too, Friday at 6 PM. Title it “How we planned a month of posts in an hour” and mark it not made for kids.”
  • Upload with a teaser

    “Schedule my video for Sunday at 5 PM with this title and description, and post a teaser on Instagram and X an hour earlier.”
  • Read the numbers

    “Which of my YouTube videos from the last 90 days got the most views and comments?”

MCP tools it uses

  • list_accounts
  • cross_post
  • list_scheduled_posts
  • update_scheduled_post
  • delete_scheduled_post
  • create_media_upload
  • create_upload_link
  • get_account_insights
  • list_content_insights
  • get_posting_times

The same workspace API key works with the REST API:

https://aghost.app/api/v1

Keep the keys

Agents cannot create API keys, change workspace settings, or connect or disconnect accounts. Revoke a key or an app in Settings → API whenever you’re finished.

What your agent can access

Frequently asked questions

Can my agent upload YouTube Shorts?

Yes. A vertical or square video of up to 3 minutes publishes as a Short.

What does every YouTube video need?

A title of up to 100 characters and YouTube's audience setting: whether the video is made for kids.

Can it post images or community posts?

No. Each YouTube post here is one video.

Which AI agents can use it?

Claude, Claude Code, Codex, Cursor, or any MCP client over HTTP. Apps with MCP sign-in need only the URL; other clients send a workspace API key.

How much does it cost?

MCP access is included on every aghost plan, from $29/month, with a 7-day free trial.

Your audience is everywhere. Be there with one post.

Six platforms. Every comment answered. One workspace.