skill

tiktok-mcp

Post, schedule, manage, and analyze TikTok accounts from any MCP-compatible AI agent.

0xArtex/tiktok-mcpcommunitylistedunreviewed

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/0xArtex/tiktok-mcp itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 28, 2026

Allow any AI agent to use the full TikTok interface through this self-hosted MCP. With this MCP you can:

Post/schedule videos
Manage profile; pfp, display name, and bio
Find viral tiktok hooks
Track analytics from TikTok Studio

Works with any MCP-compatible agent or CLI(Claude Code, Codex, Hermes Agent, etc.). Maintained by Palmyr

You can connect unlimited number of accounts. The agent will keep all TikTok sessions, media, browser profiles, and analytics local.

Tools

Tool	What it does
`tiktok_connect`	Return a shareable QR login link
`tiktok_connect_status`	Check whether login completed
`tiktok_accounts`	List local accounts and session state
`tiktok_post`	Post or natively schedule a video
`tiktok_operation_status`	Poll an asynchronous browser job
`tiktok_follow`	Follow a user
`tiktok_like`	Like a video
`tiktok_delete`	Delete a video
`tiktok_update_profile`	Update a display name or bio
`tiktok_update_avatar`	Update a profile image
`tiktok_analytics`	Collect and save post metrics locally
`tiktok_series`	Read saved performance history and growth
`tiktok_hooks`	Analyze caption hooks from local history
`tiktok_niches`	List suggested hook-analysis niches
`tiktok_scheduled`	List scheduled posts recorded locally
`tiktok_cancel_scheduled`	Cancel a scheduled post

Quick start

You need Node.js 18.18+ and Chrome, Edge, or Brave. Add this server to your agent's MCP configuration:

{
  "mcpServers": {
    "tiktok": {
      "command": "npx",
      "args": ["-y", "github:0xArtex/tiktok-mcp"]
    }
  }
}

Restart the agent, then ask:

Connect my TikTok account as [my-brand]

The MCP returns a shareable connect_url. Send it to the human who owns the account; they open it, scan the live TikTok QR, and confirm login while the agent polls the connection.

Important: make sure the agent's VPS/browser and the human's phone to be in the same country or a nearby region, since TikTok may refuse geographically distant QR logins. If they are different, we suggest to use a temporarily VPN/proxy while scanning.

If no installed browser is detected, install Playwright's Chromium once:

npx playwright install chromium

On a Linux VPS without a desktop display, install Xvfb so TikTok receives a headed browser while the human uses the remote link:

sudo apt-get install -y xvfb

Hosted HTTP API

Don't want to run the browser/runtime yourself? Use our hosted x402 API at https://tiktok.palmyr.ai/v1 with AgentCash, Agentic Market, or any x402 client. It is an HTTP API, not a remote MCP server.

npx agentcash@latest add https://tiktok.palmyr.ai
npx agentcash@latest discover https://tiktok.palmyr.ai
npx agentcash@latest check https://tiktok.palmyr.ai/v1/post

AgentCash handles the x402 challenge and USDC payment.

The paid hosted automation API is optional.

Local configuration

Setting	Default	Description
`TIKTOK_MCP_DATA_DIR`	`~/.tiktok-mcp`	Local profiles, job state, and analytics
`TIKTOK_BROWSER_PATH`	auto-detected	Chrome-family browser executable
`TIKTOK_HEADLESS`	headed on desktop	Set `true` for headless operation
`TIKTOK_CONNECT_RELAY_URL`	`https://tiktok.palmyr.ai`	Ephemeral QR hand-off origin

Development

git clone https://github.com/0xArtex/tiktok-mcp.git
cd tiktok-mcp
npm install
npm test

License

MIT