🎵 TikTok MCP Server

⚡ Why tiktok-mcp?

Most TikTok MCP servers only let you read data. This one lets you act.

• 🔍 Browse — Search videos, explore hashtags, scroll the For You Page
• 📥 Download — Save videos without watermark (HD when available)
• 📤 Publish — Upload videos directly to TikTok via Creator Center
• 💬 Interact — Like, comment, and follow — all automated
• 📊 Analyze — Cross-keyword trend analysis with top hashtags & creators

12 tools. One server. Full TikTok automation.

🛠️ All 12 Tools

🚀 Installation (3 Steps)

1. Clone & Install

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

2. Get Your TikTok Cookies

You need authenticated cookies for publish/interact features. Two options:

Option A — From TikSimPro (recommended):

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

Option B — Export manually:

1. Log into TikTok in your browser
2. Use a cookie export extension (e.g., "Get cookies.txt")
3. Save as JSON:

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

3. Set Environment Variables

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"

⚙️ Configuration

Claude Desktop (claude_desktop_config.json)

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

mcporter

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

Direct (stdio)

tiktok-mcp
# or
python -m tiktok_mcp

📖 Usage Examples

🔍 Search Videos

Use tiktok_search to find "AI productivity" videos

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

📊 Analyze a Niche

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

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

👤 Research a Creator

Get the last 20 videos from @garyvee

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

📥 Download a Video

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

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

📤 Publish a Video

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"]
}

💬 Interact (Like / Comment / Follow)

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"}

🎵 Trending Sounds

What sounds are trending on TikTok right now?

{"count": 20}

🔐 Session Management

Check if my TikTok session is still active

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

🏆 Comparison — Why This One?

tiktok-mcp is the only MCP server that lets you publish and interact on TikTok.

📸 Demo

🏗️ Built With

• Playwright — Browser automation with stealth capabilities
• playwright-stealth — Anti-detection patches
• MCP SDK — Model Context Protocol for AI integration
• TikSimPro — Cookie management & TikTok session handling
• tikwm — Watermark-free video downloads
• httpx — Async HTTP client

🤝 Contributing

Contributions are welcome! Here's how:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Ideas for contributions:

• 📱 Mobile viewport support
• 🌍 Multi-language support
• 📊 Advanced analytics (engagement rate, best posting times)
• 🔄 Scheduled posting
• 🎭 Multiple account support

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.