Skip to main content
Glama

YouTube Shorts & Instagram Reels MCP Server

by suriyaprakash-25
GitHub
Python
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

YouTube Shorts & Instagram Reels MCP Server

A Model Context Protocol (MCP) compatible FastAPI server that enables automated posting of videos to YouTube Shorts and Instagram Reels.

Features

  • 🎬 YouTube Shorts Upload: Automatic detection and upload of short-form videos to YouTube
  • 📱 Instagram Reels Upload: Direct upload to Instagram Reels with caption support
  • 🔐 OAuth 2.0 Authentication: Secure authentication for both platforms
  • 🛡️ File Validation: Comprehensive file type and size validation
  • 🔄 Token Refresh: Automatic OAuth token refresh for YouTube
  • 🎯 MCP Compatible: Full MCP tool integration for seamless automation
  • ⚡ Async Operations: High-performance async file handling
  • 📏 Video Processing: Automatic video duration detection using ffprobe

Quick Start

  1. Install dependencies:
pip install -r requirements.txt
  1. Configure credentials:
cp .env.example .env # Edit .env with your API credentials (see setup sections below)
  1. Start the server:
python main.py
  1. Test the API:
  • Visit http://localhost:8000/docs for interactive API documentation
  • Use the /upload/youtube and /upload/instagram endpoints
  • Access MCP tools at http://localhost:8000/mcp

API Endpoints

Upload to YouTube Shorts

POST /upload/youtube Content-Type: multipart/form-data file: <video_file> title: "My Amazing Short" description: "Check out this cool video!" tags: "shorts,viral,amazing"

Response:

{ "success": true, "video_id": "dQw4w9WgXcQ", "watch_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

Upload to Instagram Reels

POST /upload/instagram Content-Type: multipart/form-data file: <video_file> caption: "Check out my new reel! #viral #reels"

Response:

{ "success": true, "reel_id": "17841234567890123", "permalink": "https://www.instagram.com/reel/ABC123def456/" }

MCP Tool Usage

The server exposes two MCP tools for programmatic access:

post_to_youtube

await post_to_youtube( title="My Video Title", description="Video description", tags=["tag1", "tag2", "tag3"], video_path="/path/to/video.mp4" )

post_to_instagram

await post_to_instagram( caption="My reel caption #hashtag", video_path="/path/to/video.mp4" )

Prerequisites & Setup

YouTube API Setup

  1. Google Cloud Console:
    • Go to Google Cloud Console
    • Create a new project or select existing one
    • Enable YouTube Data API v3 in the API Library
    • Create OAuth 2.0 credentials (Desktop application)
  2. Get OAuth Tokens:
    • Use Google OAuth 2.0 Playground
    • Configure with your Client ID and Secret
    • Select https://www.googleapis.com/auth/youtube.upload scope
    • Complete OAuth flow and get access_token + refresh_token

Instagram API Setup

  1. Facebook Developer Account:
  2. Instagram Business Account:
    • Connect your Instagram Business/Creator account to a Facebook Page
    • Generate access token with proper permissions
    • Get your Instagram User ID
  3. File Hosting (Required):
    • Instagram requires publicly accessible video URLs
    • Configure AWS S3, Cloudinary, or custom hosting in .env
    • Videos are temporarily uploaded to hosting service before Instagram API call

Configuration

Environment Variables

Copy .env.example to .env and configure:

# YouTube API Credentials YOUTUBE_CLIENT_ID=your_client_id.apps.googleusercontent.com YOUTUBE_CLIENT_SECRET=GOCSPX-your_client_secret YOUTUBE_ACCESS_TOKEN=ya29.your_access_token YOUTUBE_REFRESH_TOKEN=1//your_refresh_token # Instagram API Credentials INSTAGRAM_ACCESS_TOKEN=IGAAyour_instagram_token INSTAGRAM_APP_ID=your_app_id INSTAGRAM_APP_SECRET=your_app_secret INSTAGRAM_USER_ID=your_user_id # Server Configuration HOST=0.0.0.0 PORT=8000 DEBUG=False # File Upload Configuration MAX_FILE_SIZE_MB=100 ALLOWED_VIDEO_EXTENSIONS=mp4,mov,avi,mkv,webm

File Requirements

Supported Formats

  • Video: MP4, MOV, AVI, MKV, WebM
  • Max Size: 100MB (configurable)
  • Duration: Recommended under 60 seconds for optimal Shorts detection

YouTube Shorts Criteria

  • Videos under 60 seconds are automatically tagged as Shorts
  • Vertical or square aspect ratios work best
  • Resolution: 1080x1920 (9:16) recommended

Instagram Reels Criteria

  • Duration: 3-90 seconds
  • Aspect ratio: 9:16 (vertical) recommended
  • Resolution: 1080x1920 recommended

Testing

Test the Server

# Test health endpoint curl http://localhost:8000/health # Test YouTube upload curl -X POST "http://localhost:8000/upload/youtube" \ -F "file=@test_video.mp4" \ -F "title=Test Video" \ -F "description=Test Description" \ -F "tags=test,api" # Test Instagram upload curl -X POST "http://localhost:8000/upload/instagram" \ -F "file=@test_video.mp4" \ -F "caption=Test reel #test"

Run Test Suite

python test_server.py

Error Handling

The server provides detailed error responses:

{ "success": false, "error": "File too large. Maximum size is 100MB" }

Common error scenarios:

  • Invalid file format
  • File too large
  • Authentication failures
  • API rate limits
  • Network timeouts

Troubleshooting

Common Issues

  1. YouTube Authentication Errors
    • Verify OAuth credentials are correct
    • Check if access token has expired (auto-refreshed)
    • Ensure YouTube Data API v3 is enabled
  2. Instagram Upload Failures
    • Verify Instagram Business/Creator account is linked
    • Check access token permissions
    • Ensure video meets Instagram requirements
    • Configure file hosting (AWS S3, Cloudinary, etc.)
  3. File Upload Issues
    • Check file size limits
    • Verify file format is supported
    • Ensure sufficient disk space for temporary files

Logs and Debugging

Enable debug mode for detailed logging:

DEBUG=True python main.py

Security Considerations

  • Store credentials in environment variables, never in code
  • Use HTTPS in production
  • Implement rate limiting
  • Validate all file uploads
  • Monitor API usage quotas

License

MIT License - see LICENSE file for details.

File Requirements

Supported Formats

  • Video: MP4, MOV, AVI, MKV, WebM
  • Max Size: 100MB (configurable)
  • Duration: Recommended under 60 seconds for optimal Shorts detection

YouTube Shorts Criteria

  • Videos under 60 seconds are automatically tagged as Shorts
  • Vertical or square aspect ratios work best
  • Resolution: 1080x1920 (9:16) recommended

Instagram Reels Criteria

  • Duration: 15-90 seconds
  • Aspect ratio: 9:16 (vertical) recommended
  • Resolution: 1080x1920 recommended

Configuration

Environment variables can be customized:

# Server Configuration HOST=0.0.0.0 PORT=8000 DEBUG=False # File Upload Configuration MAX_FILE_SIZE_MB=100 ALLOWED_VIDEO_EXTENSIONS=mp4,mov,avi,mkv,webm # API Rate Limiting RATE_LIMIT_REQUESTS_PER_MINUTE=60

Error Handling

The server provides detailed error responses:

{ "success": false, "error": "File too large. Maximum size is 100MB" }

Common error scenarios:

  • Invalid file format
  • File too large
  • Authentication failures
  • API rate limits
  • Network timeouts

Security Considerations

  • Store credentials in environment variables, never in code
  • Use HTTPS in production
  • Implement rate limiting
  • Validate all file uploads
  • Monitor API usage quotas

Development

Running in Development Mode

DEBUG=True python main.py

Testing the API

# Test health endpoint curl http://localhost:8000/health # Test YouTube upload curl -X POST "http://localhost:8000/upload/youtube" \ -F "file=@test_video.mp4" \ -F "title=Test Video" \ -F "description=Test Description" \ -F "tags=test,api"

Troubleshooting

Common Issues

  1. YouTube Authentication Errors
    • Verify OAuth credentials are correct
    • Check if access token has expired
    • Ensure YouTube Data API v3 is enabled
  2. Instagram Upload Failures
    • Verify Instagram Business/Creator account is linked
    • Check access token permissions
    • Ensure video meets Instagram requirements
  3. File Upload Issues
    • Check file size limits
    • Verify file format is supported
    • Ensure sufficient disk space for temporary files

Logs and Debugging

Enable debug mode for detailed logging:

DEBUG=True python main.py

License

MIT License - see LICENSE file for details.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests
  5. Submit a pull request

Support

For issues and questions:

  • Check the troubleshooting section
  • Review API documentation
  • Open an issue on GitHub

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables automated posting of videos to YouTube Shorts and Instagram Reels with OAuth 2.0 authentication, file validation, and comprehensive video processing capabilities. Provides MCP-compatible tools for seamless social media video uploads through a FastAPI server.

  1. Features
    1. Quick Start
      1. API Endpoints
        1. Upload to YouTube Shorts
        2. Upload to Instagram Reels
      2. MCP Tool Usage
        1. post_to_youtube
        2. post_to_instagram
      3. Prerequisites & Setup
        1. YouTube API Setup
        2. Instagram API Setup
      4. Configuration
        1. Environment Variables
      5. File Requirements
        1. Supported Formats
        2. YouTube Shorts Criteria
        3. Instagram Reels Criteria
      6. Testing
        1. Test the Server
        2. Run Test Suite
      7. Error Handling
        1. Troubleshooting
          1. Common Issues
          2. Logs and Debugging
        2. Security Considerations
          1. License
            1. File Requirements
              1. Supported Formats
              2. YouTube Shorts Criteria
              3. Instagram Reels Criteria
            2. Configuration
              1. Error Handling
                1. Security Considerations
                  1. Development
                    1. Running in Development Mode
                    2. Testing the API
                  2. Troubleshooting
                    1. Common Issues
                    2. Logs and Debugging
                  3. License
                    1. Contributing
                      1. Support

                        Related MCP Servers

                        • DeepSRT MCP Serverofficial

                          DeepSRT
                          A
                          security
                          F
                          license
                          A
                          quality
                          An MCP server that enables users to generate summaries of YouTube videos in multiple languages and formats through integration with DeepSRT's API.
                          Last updated -
                          1
                          2
                          44
                          TypeScript
                          • Apple

                        • Instagram Video Downloader MCP Server

                          handoing
                          A
                          security
                          F
                          license
                          A
                          quality
                          A lightweight MCP service that enables programmatic downloading of Instagram videos to a specified local path with progress tracking.
                          Last updated -
                          1
                          2
                          JavaScript

                        • YouTube Toolbox

                          jikime
                          A
                          security
                          F
                          license
                          A
                          quality
                          An MCP server that provides AI assistants with powerful tools to interact with YouTube, including video searching, transcript extraction, comment retrieval, and more.
                          Last updated -
                          8
                          15
                          Python
                          • Linux
                          • Apple

                        • Youtube Uploader MCP

                          anwerj
                          -
                          security
                          A
                          license
                          -
                          quality
                          - Upload videos to YouTube from MCP - Client(Claude/Cursor/VS Code) - OAuth2 authentication flow - Access token and refresh token management - Multi Channel Support
                          Last updated -
                          16
                          Go
                          MIT License
                          • Linux
                          • Apple

                        View all related MCP servers

                        New MCP Servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/suriyaprakash-25/mcp'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server