Automation

TikTok LIVE automation recipes for n8n and Claude

Three n8n workflows you can import as they are, and a prompt pack for the TikTok LIVE MCP server in Claude. Each recipe names the plan it needs, and each was run against the live API with keys on every plan before it was published here.

n8n: creator goes live, message on Telegram

Plan: Basic or higher

When a creator you follow starts a LIVE, a Telegram message arrives with the name and a link to the stream. Go-live webhooks are not part of Sandbox.

Set up

  1. Use n8n 2.0 or newer, reachable from the internet (the webhook needs a public URL).
  2. Create a Telegram API credential with your bot token from BotFather, and a Crypto credential with your webhook secret (it starts with whsec_).
  3. Open the Telegram node and replace YOUR_TELEGRAM_CHAT_ID with your chat id. For a channel, add the bot to the channel first.
  4. Publish the workflow and copy the Production URL of the webhook node.
  5. Register the webhook for live.start with the curl command in the workflow note. The secret is shown once, so store it right away.

The workflow checks the signature and the timestamp on every request and ignores anything that is not a fresh, signed live.start. A delivery can be retried, so the same event_id can arrive twice; filter on it if a duplicate message matters to you.

n8n: daily recruit list on Telegram

Plan: Agency Global

Every morning at 08:00 (n8n time zone) a Telegram message lists creators first seen since yesterday in a region you choose, highest estimated 7-day earnings first. Up to 1,000 creators per run.

Set up

  1. Create a Header Auth credential: name x-api-key, value your API key. Create a Telegram API credential with your bot token.
  2. In the Settings node, set the region, the minimum estimated 7-day earnings and the number of rows.
  3. Replace YOUR_TELEGRAM_CHAT_ID in the Telegram node and activate the workflow.

Lower plans receive an access error from this feed. Creators your team marked as not eligible with the Backstage checker are left out.

n8n: weekly roster report on Telegram

Plan: Agency Global

Every Monday at 09:00, one Telegram summary per creator list: members, who is live, diamonds and battles over the last 7 days, and the top earners. Up to 50 lists and 500 creators per run.

Set up

  1. Create the same Header Auth credential (x-api-key) and a Telegram API credential.
  2. Replace YOUR_TELEGRAM_CHAT_ID in the Telegram node and activate the workflow.

Creator lists are managed in the agency dashboard. A creator is recorded from the day they join a list, so new members show as not recorded yet until their next streams. With no lists, nothing is sent.

Claude: TikTok LIVE MCP prompt pack

Plan: Sandbox and up, per prompt

Twelve plain-language prompts for Claude (or any MCP client) with the tiktok-live-mcp server installed, with install steps for Claude Code, Claude Desktop and Cursor. Each prompt lists the tool it calls and the lowest plan that returns real data for it.

Set up

  1. Install the server, for example in Claude Code: claude mcp add tiktok-live -e TIKTOOLS_API_KEY=YOUR_API_KEY -- npx -y tiktok-live-mcp. Node.js 18 or newer is required.
  2. Paste a prompt from the pack into a new chat.

Live status, rate limits and the gift catalog work on every plan (the catalog is a sample below Pro); checking a single live room needs Basic; creator profiles and the live feed need Pro; the gift gallery and league boards need Ultra; finding eligible creators needs Agency Global.

Before you start

  • Get your API key in the dashboard. Plans and what each includes are on the pricing page; Sandbox is a 7-day evaluation, no credit card.
  • In n8n, use Workflows, Import from File, and pick the downloaded JSON. The sticky note inside each workflow repeats the setup steps.
  • Writing your own code instead? See the migration guide and the docs.