New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →
Get Started

tiktok-creator-mcp

Package Overview
Dependencies
Maintainers
1
Versions
2
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

tiktok-creator-mcp

TikTok automation MCP: post videos, get analytics, manage comments mcprush.com-claim-tiktok-creator-mcp-dee39c37d5b3caa4adcab71f

pipPyPI
Version
1.0.1
Weekly downloads
86
Maintainers
1
Created

TikTok Creator MCP

mcp-name: io.github.wmarceau/tiktok-creator

TikTok automation tools for Claude via MCP (Model Context Protocol). Post videos, track analytics, and manage comments.

Features

  • Post Videos: Upload from local file or public URL
  • Privacy Control: Set visibility (self, friends, followers, public)
  • Analytics: Video views, likes, comments, shares
  • Account Stats: Follower count, total likes
  • Comments: Read and reply to comments
  • Interaction Controls: Enable/disable duets, stitch, comments

Installation

pip install tiktok-creator-mcp

Setup

Prerequisites

  • TikTok Developer Account: https://developers.tiktok.com
  • App with Content Posting API access

1. Create TikTok App

2. OAuth Flow

TikTok uses OAuth 2.0. You'll need to:

  • Direct user to authorization URL
  • Receive authorization code
  • Exchange for access token
# Authorization URL
auth_url = f"https://www.tiktok.com/v2/auth/authorize/?client_key={CLIENT_KEY}&response_type=code&scope=user.info.basic,video.upload,video.list&redirect_uri={REDIRECT_URI}"

# Exchange code for token
token_response = requests.post(
    "https://open.tiktokapis.com/v2/oauth/token/",
    data={
        "client_key": CLIENT_KEY,
        "client_secret": CLIENT_SECRET,
        "code": auth_code,
        "grant_type": "authorization_code",
        "redirect_uri": REDIRECT_URI,
    }
)

3. Set Environment Variables

export TIKTOK_CLIENT_KEY="your_client_key"
export TIKTOK_CLIENT_SECRET="your_client_secret"
export TIKTOK_ACCESS_TOKEN="your_access_token"
export TIKTOK_REFRESH_TOKEN="your_refresh_token"

Tools

ToolDescription
post_videoPost video from local file
post_video_from_urlPost video from public URL
get_video_statsGet video performance metrics
get_account_statsFollower count, likes, videos
get_video_listList your TikTok videos
get_commentsGet video comments
reply_to_commentReply to a comment

Usage Examples

Post a Video

{
  "tool": "post_video",
  "arguments": {
    "video_path": "/path/to/video.mp4",
    "title": "Quick fitness tip! #fitness #workout",
    "privacy": "PUBLIC_TO_EVERYONE"
  }
}

Post from URL

{
  "tool": "post_video_from_url",
  "arguments": {
    "video_url": "https://example.com/video.mp4",
    "title": "Check out this workout! #gym",
    "privacy": "PUBLIC_TO_EVERYONE",
    "disable_duet": false,
    "disable_stitch": false
  }
}

Get Video Stats

{
  "tool": "get_video_stats",
  "arguments": {
    "video_id": "7123456789012345678"
  }
}

Privacy Levels

LevelDescription
SELF_ONLYOnly you can see
MUTUAL_FOLLOW_FRIENDSMutual followers only
FOLLOWER_OF_CREATORYour followers only
PUBLIC_TO_EVERYONEEveryone can see

Video Requirements

  • Format: MP4, WebM
  • Duration: 3 seconds - 10 minutes
  • Size: Max 4GB
  • Aspect Ratio: 9:16 (vertical) recommended

Rate Limits

  • Video Posts: Check TikTok Developer docs for current limits
  • API Calls: Varies by endpoint

Environment Variables

VariableRequiredDescription
TIKTOK_CLIENT_KEYYesApp client key
TIKTOK_CLIENT_SECRETYesApp client secret
TIKTOK_ACCESS_TOKENYesUser access token
TIKTOK_REFRESH_TOKENNoFor token renewal

Claude Desktop Configuration

{
  "mcpServers": {
    "tiktok-creator": {
      "command": "tiktok-creator-mcp",
      "env": {
        "TIKTOK_CLIENT_KEY": "your_key",
        "TIKTOK_CLIENT_SECRET": "your_secret",
        "TIKTOK_ACCESS_TOKEN": "your_token"
      }
    }
  }
}

License

MIT

Keywords

automation

FAQs

Related posts