TikTok

by Seym0n

179 stars
509 downloads
Not rated
GitHub

About

TikTok integration for getting post details and video subtitles

Details

Author
Seym0n
GitHub stars
179
Downloads
509
Categories
Communication, Community, Other

- Get subtitles (content) from any TikTok video
- Retrieve detailed post information including engagement metrics
- Search for TikTok videos by natural language query
- Analyze videos for virality factors
- Chat with TikTok video content via AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name TikTok
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via MCPB (easiest) by downloading the tiktok-mcp.mcpb file from GitHub Releases and opening it in Claude Desktop, then entering your TikNeuron API Key. Alternatively, clone the repository, run npm install, npm run build, and add the server to your Claude Desktop mcpServers configuration with your TikNeuron API key.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "tiktok": {
            "tiktok-mcp": {
                "command": "node",
                "args": [
                    "path\\build\\index.js"
                ],
                "env": {
                    "TIKNEURON_MCP_API_KEY": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
                }
            }
        }
    }
}

McpServers

{
    "tiktok-mcp": {
        "command": "node",
        "args": [
            "path\\build\\index.js"
        ],
        "env": {
            "TIKNEURON_MCP_API_KEY": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        }
    }
}

TikTok MCP

image (12)

The TikTok MCP integrates TikTok access into Claude AI and other apps via TikNeuron. This TikTok MCP allows you to
- analyze TikTok videos to determine virality factors
- get content from TikTok videos
- chat with TikTok videos

Available Tools

tiktok_get_subtitle

Description:
Get the subtitle (content) for a TikTok video url. This is used for getting the subtitle, content or context for a TikTok video. If no language code is provided, the tool will return the subtitle of automatic speech recognition.

Input Parameters:
- tiktok_url (required): TikTok video URL, e.g., https://www.tiktok.com/@username/video/1234567890 or https://vm.tiktok.com/1234567890
- language_code (optional): Language code for the subtitle, e.g., en for English, es for Spanish, fr for French, etc.

tiktok_get_post_details

Description:
Get the details of a TikTok post. Returns the details of the video like:
- Description
- Video ID
- Creator username
- Hashtags
- Number of likes, shares, comments, views and bookmarks
- Date of creation
- Duration of the video
- Available subtitles with language and source information

Input Parameters:
- tiktok_url (required): TikTok video URL, e.g., https://www.tiktok.com/@username/video/1234567890 or https://vm.tiktok.com/1234567890, or just the video ID like 7409731702890827041

tiktok_search

Description:
Search for TikTok videos based on a query. Returns a list of videos matching the search criteria with their details including description, video ID, creator, hashtags, engagement metrics, date of creation, duration and available subtitles, plus pagination metadata for continuing the search.

Input Parameters:
- query (required): Search query for TikTok videos, e.g., 'funny cats', 'dance', 'cooking tutorial'
- cursor (optional): Pagination cursor for getting more results
- search_uid (optional): Search session identifier for pagination

Install via MCPB (Easiest)

The easiest way to install the TikTok MCP in Claude Desktop is via the MCPB bundle — no cloning or building required.

1. Download the latest tiktok-mcp.mcpb from the Releases page
2. Open the .mcpb file — Claude Desktop will show an installation dialog
3. Enter your TikNeuron API Key when prompted

That's it. Claude Desktop handles the rest automatically.

Requirements

For this TikTok MCP, you need
- NodeJS v18 or higher (https://nodejs.org/)
- Git (https://git-scm.com/)
- TikNeuron Account and MCP API Key (https://tikneuron.com/tools/tiktok-mcp)

Setup

1. Clone the repository

git clone https://github.com/Seym0n/tiktok-mcp.git

2. Install dependencies

npm install

3. Build project

npm run build

This creates the file build\index.js

Using in Claude AI

Add the following entry to mcpServers:

"tiktok-mcp": {
    "command": "node",
    "args": [
      "path\\build\\index.js"
    ],
    "env": {
      "TIKNEURON_MCP_API_KEY": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
    }
}

and replace path with the path to TikTok MCP and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX with TIkNeuron API Key

so that mcpServers will look like this:

{
  "mcpServers": {
    "tiktok-mcp": {
      "command": "node",
      "args": [
        "path\\build\\index.js"
      ],
      "env": {
        "TIKNEURON_MCP_API_KEY": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.