git clone https://github.com/follox42/tiktok-mcp.git
cd tiktok-mcp
pip install -e .
playwright install chromium

# If you use TikSimPro, cookies are already at:
~/TikSimPro/tiktok_cookies.pkl

[
  {"name": "sessionid", "value": "xxx", "domain": ".tiktok.com", "path": "/"},
  {"name": "sid_tt", "value": "xxx", "domain": ".tiktok.com", "path": "/"}
]

export TIKTOK_COOKIES_PATH="/path/to/your/cookies.pkl"  # or .json
export TIKTOK_HEADLESS=true       # false to see the browser
export TIKTOK_MIN_INTERVAL=2.0    # rate limit between calls (seconds)
export TIKTOK_DOWNLOAD_DIR="./downloads"

{
  "mcpServers": {
    "tiktok": {
      "command": "tiktok-mcp",
      "env": {
        "TIKTOK_COOKIES_PATH": "/home/you/TikSimPro/tiktok_cookies.pkl",
        "TIKTOK_HEADLESS": "true"
      }
    }
  }
}

{
  "servers": {
    "tiktok": {
      "command": "tiktok-mcp",
      "env": {
        "TIKTOK_COOKIES_PATH": "/home/you/TikSimPro/tiktok_cookies.pkl"
      }
    }
  }
}

tiktok-mcp
# or
python -m tiktok_mcp

Use tiktok_search to find "AI productivity" videos

{"query": "AI productivity", "count": 10}

Analyze trends for "solopreneur" and "indie hacker" — what hashtags and creators dominate?

{"keywords": ["solopreneur", "indie hacker", "build in public"], "count_per_keyword": 15}

Get the last 20 videos from @garyvee

{"username": "garyvee", "count": 20}

Download this video without watermark: https://www.tiktok.com/@user/video/123456

{"video_url": "https://www.tiktok.com/@user/video/123456"}

Publish my video with caption "Building in public day 47 🚀" and hashtags buildinpublic, startup, coding

{
  "video_path": "/path/to/video.mp4",
  "caption": "Building in public day 47 🚀",
  "hashtags": ["buildinpublic", "startup", "coding"]
}

Like this video and leave a comment: "This is incredible! 🔥"

{"action": "like", "video_url": "https://www.tiktok.com/@user/video/123456"}
{"action": "comment", "video_url": "https://www.tiktok.com/@user/video/123456", "text": "This is incredible! 🔥"}
{"action": "follow", "video_url": "https://www.tiktok.com/@user/video/123456"}

What sounds are trending on TikTok right now?

{"count": 20}

Check if my TikTok session is still active

{"action": "check_login"}
{"action": "refresh_cookies"}
{"action": "export_session"}