How to add TikTok MCP to Windsurf

Search TikTok, pull post details, and extract video subtitles into your AI agent via the TikNeuron API. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 174★ · stdio · apikey

Windsurf config for TikTok MCP

git clone https://github.com/Seym0n/tiktok-mcp.git && cd tiktok-mcp && npm install && npm run build

{
  "mcpServers": {
    "tiktok-mcp": {
      "command": "node",
      "args": [
        "<path-to-tiktok-mcp>/build/index.js"
      ],
      "env": {
        "TIKNEURON_MCP_API_KEY": "<your-tikneuron-api-key>"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the TikTok MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5TikTok MCP's tools become available to Cascade.

Before you start

Node.js v18 or higher
Git (to clone and build the server)
TikNeuron account and MCP API key from tikneuron.com/tools/tiktok-mcp

What TikTok MCP can do in Windsurf

tiktok_get_subtitle

Get subtitle/caption text for a TikTok video URL; falls back to automatic speech recognition, optional language code.

tiktok_get_post_details

Get post details: description, creator, hashtags, likes/shares/comments/views/bookmarks, creation date, duration, available subtitles.

tiktok_search

Search TikTok videos by query with engagement metrics and pagination via cursor and search_uid.

Security

Read-only access to public TikTok data, but every query is routed through TikNeuron's servers with your API key, so treat prompts and URLs as shared with that third party. The key sits in plain text in your MCP config env; TikNeuron is a paid service with per-request credits.

TikTok MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the TikTok MCP config there under the "mcpServers" key and restart the client.

Is TikTok MCP safe to use with Windsurf?

Is TikTok MCP free to use?

The server code is MIT-licensed and free, but it requires a TikNeuron API key, and TikNeuron is a paid third-party service with request credits. TikTok data flows through TikNeuron's infrastructure, not directly from TikTok.

Do I need a TikTok account or login?

No. The server only reads public TikTok content through the TikNeuron API, so no TikTok credentials are involved. You only authenticate against TikNeuron.

Can it download TikTok videos?

No. It retrieves text and metadata only: subtitles (uploaded or ASR-generated), post details, and search results. For video files you'd need a different tool.

View repo Full TikTok MCP page