Log inSubmit server
TikTok Shop logo

TikTok Shop

Read-only MCP access to TikTok Shop orders, finance, products, analytics, returns, and affiliate performance across multiple shops.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install TikTok Shop

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tiktok-shop": {
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ],
      "env": {
        "TIKTOK_SHOP_CONFIG": "YOUR_VALUE_HERE",
        "TIKTOK_SHOP_BESTSELLERS_SHOP": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

TikTok Shop MCP server connects MCP clients to the TikTok Shop Partner API for read-only access to orders, finance, products, analytics, returns, cancellations, and affiliate performance. It supports multiple shops through a JSON configuration file and lets each tool select a shop by partial seller name. Human-readable dates and IANA time zones are converted for API requests, while token tools inspect and refresh credentials. Use it when an AI assistant needs structured TikTok Shop data without browser scraping or write access.

Use cases

  • Query orders for a shop over a date range
  • Compare hourly GMV across two days
  • Retrieve settlement statements and transactions
  • Identify top-performing products and creators
  • Refresh access tokens for multiple shops

Key features

  • Read-only TikTok Shop Partner API access
  • Multi-shop JSON configuration
  • 22 tools for commerce and analytics data
  • Human-readable dates with IANA time zones
  • Token inspection and refresh
  • Retry handling for rate limits and transient errors

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2h ago via OSV.dev · tiktok-shop-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars7Stargazers on the source repository.
Last commit3d agoMost recent push to the default branch.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How TikTok Shop works

What TikTok Shop does

The TikTok Shop MCP server exposes the TikTok Shop Partner API to MCP-compatible AI clients. It is designed for sellers and agencies managing one or more shops and provides structured JSON responses rather than browser-based automation. The implementation is read-only for shop data: tools do not edit listings, create products, or upload files.

Its 22 tools cover shop discovery and token management, orders, returns, cancellations, finance, products, shop performance, hourly performance, SKU metrics, customer service metrics, video performance, and affiliate-related best-seller data. This makes the TikTok Shop MCP server suitable for questions such as which products sold during a period, how a shop performed by hour, or which creators generated the most GMV.

How it works

The server uses a signed HTTP client to call the official TikTok Shop Partner API. Requests use HMAC-SHA256 signing and pass through retry handling with exponential backoff and jitter for rate limits, server errors, and network failures. Responses are structured JSON; errors include a message and suggestion so an assistant can potentially correct a request or refresh an expired token.

Configure any number of shops in one JSON file. Every relevant tool accepts an optional seller_name; partial matching selects the intended shop. Date parameters can be supplied as calendar dates with an IANA time zone instead of Unix timestamps, and the server performs the conversion before making the request.

The three best-seller tools use platform-wide lists. They require a shop whose Partner Center app has the Bestsellers scope. TIKTOK_SHOP_BESTSELLERS_SHOP can identify that shop when a tool call does not provide seller_name; otherwise, the first configured shop is used.

Setup and configuration

Install the package with pip install tiktok-shop-mcp, or clone the repository and install its pinned direct dependencies in a virtual environment. The package supports MCP 1.x and 2.x; the published requirements pin MCP 2.1.1.

Credentials are stored outside the repository, by default at ~/.config/tiktok-mcp/shops.json. Set TIKTOK_SHOP_CONFIG to use another path. Each shop entry contains a seller name, base region, app credentials, access and refresh tokens, shop ID, and shop cipher. App credentials and authorization tokens come from TikTok Shop Partner Center, while the authorized-shops endpoint provides shop identifiers. The included probe_authorized_shops.py script can help retrieve them.

For a local MCP client, run tiktok-shop-mcp as the server command. Claude Code can add it with claude mcp add tiktok-shop -- tiktok-shop-mcp; other clients can use a standard stdio configuration and pass the configuration path as an environment variable. Restrict the configuration directory and file to the owner with chmod 700 and chmod 600.

Tools and capabilities

The TikTok Shop MCP server groups its tools as follows:

  • Shops and authentication: list shops, inspect token status, refresh one token, or refresh all tokens.
  • Orders: retrieve shop orders and order details, then search returns and cancellations.
  • Finance: retrieve statements and transactions.
  • Products: list catalog products and inspect product details.
  • Analytics: query shop, hourly, product, SKU, video, and customer service performance.
  • Video and affiliate data: retrieve account video GMV plus best-selling videos, creators, and products.

Limitations and notes

Only read scopes should be authorized for defense in depth. The server writes to the shop configuration only when refreshing tokens, and it applies owner-only permissions. Setup scripts may leave timestamped backups, a recovery directory, and a lock file beside the configuration; the backups can be removed after setup, while the lock file should remain.

This project is independent and is not affiliated with or endorsed by TikTok. API use remains subject to TikTok's terms. The project is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about TikTok Shop

TikTok Shop is an MCP server that connects AI assistants to the TikTok Shop Partner API. Its main tools read orders, finance, products, shop and video analytics, affiliate best-seller data, returns, cancellations, and shop token status across configured shops. It does not modify listings or upload files.

Install it with `pip install tiktok-shop-mcp`. You can also clone the repository, create a virtual environment, and install the pinned requirements before installing the package from source.

Put shop credentials in `~/.config/tiktok-mcp/shops.json`, or set `TIKTOK_SHOP_CONFIG` to another JSON path. Create the app and authorize shops through TikTok Shop Partner Center, then provide the returned tokens, shop ID, and shop cipher.

Yes. Claude Desktop can run it through a standard stdio MCP configuration using `tiktok-shop-mcp` as the command. Set `TIKTOK_SHOP_CONFIG` in the client environment when the credentials file is not at its default location.

No. Its tools are read-only and do not edit listings, create products, upload files, or otherwise modify shop data. Token refreshes may update the local shops configuration file.

Related MCP servers

All in E-Commerce All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTikTok Shop AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tiktok-shop?style=directory)](https://allmcps.com/mcp/tiktok-shop)
HTML Embed
<a href="https://allmcps.com/mcp/tiktok-shop"><img src="https://allmcps.com/api/badge/tiktok-shop?style=directory" alt="TikTok Shop on AllMCPs" /></a>