Tiktok MCP

1# <img src="https://cdn.worldvectorlogo.com/logos/tiktok-icon-2.svg" height="32"> TikTok MCP
2 
3![image (12)](https://github.com/user-attachments/assets/006f9983-b9dd-447c-87c6-ee27a414fd4c)
4 
5 
6The TikTok MCP integrates TikTok access into Claude AI and other apps via TikNeuron. This TikTok MCP allows you to
7- analyze TikTok videos to determine virality factors
8- get content from TikTok videos
9- chat with TikTok videos
10 
11## Available Tools
12 
13### tiktok_get_subtitle
14 
15**Description:**  
16Get 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.
17 
18**Input Parameters:**
19- `tiktok_url` (required): TikTok video URL, e.g., https://www.tiktok.com/@username/video/1234567890 or https://vm.tiktok.com/1234567890
20- `language_code` (optional): Language code for the subtitle, e.g., en for English, es for Spanish, fr for French, etc.
21 
22### tiktok_get_post_details
23 
24**Description:**  
25Get the details of a TikTok post. Returns the details of the video like:
26- Description
27- Video ID
28- Creator username
29- Hashtags
30- Number of likes, shares, comments, views and bookmarks
31- Date of creation
32- Duration of the video
33- Available subtitles with language and source information
34 
35**Input Parameters:**
36- `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
37 
38### tiktok_search
39 
40**Description:**  
41Search 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.
42 
43**Input Parameters:**
44- `query` (required): Search query for TikTok videos, e.g., 'funny cats', 'dance', 'cooking tutorial'
45- `cursor` (optional): Pagination cursor for getting more results
46- `search_uid` (optional): Search session identifier for pagination
47 
48## Requirements
49 
50For this TikTok MCP, you need
51- NodeJS v18 or higher (https://nodejs.org/)
52- Git (https://git-scm.com/)
53- TikNeuron Account and MCP API Key (https://tikneuron.com/tools/tiktok-mcp)
54 
55## Setup
56 
571. Clone the repository
58```
59git clone https://github.com/Seym0n/tiktok-mcp.git
60```
61 
622. Install dependencies
63```
64npm install
65```
66 
673. Build project
68```
69npm run build
70```
71 
72This creates the file `build\index.js`
73 
74## Using in Claude AI
75 
76Add the following entry to `mcpServers`:
77 
78```
79"tiktok-mcp": {
80    "command": "node",
81    "args": [
82      "path\\build\\index.js"
83    ],
84    "env": {
85      "TIKNEURON_MCP_API_KEY": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
86    }
87}
88```
89 
90and replace path with the `path` to TikTok MCP and `XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX` with TIkNeuron API Key
91 
92so that `mcpServers` will look like this:
93 
94```
95{
96  "mcpServers": {
97    "tiktok-mcp": {
98      "command": "node",
99      "args": [
100        "path\\build\\index.js"
101      ],
102      "env": {
103        "TIKNEURON_MCP_API_KEY": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
104      }
105    }
106  }
107}
108```
109