# TikTok Shop

This MCP server lets Claude Code read TikTok Shop Partner API data for orders, finance, products, analytics, and affiliate results across shops.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: Buer2333
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Buer2333/tiktok-shop-mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/tiktok-shop

## What it does

TikTok Shop exposes read access to the TikTok Shop Partner API through MCP tools. An agent can inspect orders, returns, statements, transactions, product records, shop metrics, video results, SKU data, and creator or product bestsellers. Responses use structured JSON.

Shop credentials belong in `shops.json` outside the project directory, with its location controlled by `TIKTOK_SHOP_CONFIG`. Setup requires `app_key`, `app_secret`, access and refresh tokens, `shop_id`, and `shop_cipher` obtained through TikTok Shop Partner Center. The server does not edit listings or upload files; token renewal writes to its configuration file. Bestseller tools also require the Bestsellers scope and can use `TIKTOK_SHOP_BESTSELLERS_SHOP` to select the shop.

The server supports `mcp` 1.x and 2.x. Add it to Claude Code with the `uvx` command, then ask the agent for shop data or token status.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `TIKTOK_SHOP_CONFIG`, `TIKTOK_SHOP_BESTSELLERS_SHOP` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> --env TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> --transport stdio tiktok-shop -- uvx tiktok-shop-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiktok-shop-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add tiktok-shop --env TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> --env TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> -- uvx tiktok-shop-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiktok-shop-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tiktok-shop": {
            "command": "uvx",
            "args": [
                "tiktok-shop-mcp"
            ],
            "env": {
                "TIKTOK_SHOP_CONFIG": "<TIKTOK_SHOP_CONFIG>",
                "TIKTOK_SHOP_BESTSELLERS_SHOP": "<TIKTOK_SHOP_BESTSELLERS_SHOP>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiktok-shop-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tiktok-shop": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "tiktok-shop-mcp"
            ],
            "env": {
                "TIKTOK_SHOP_CONFIG": "<TIKTOK_SHOP_CONFIG>",
                "TIKTOK_SHOP_BESTSELLERS_SHOP": "<TIKTOK_SHOP_BESTSELLERS_SHOP>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiktok-shop-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> -e TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> tiktok-shop uvx tiktok-shop-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiktok-shop-mcp <command>

## When to use it
- inspect orders for a selected shop and date
- check statements against shop transactions
- identify products or SKUs with strong metrics
- compare hourly shop performance
- refresh access tokens across shops

## Example prompts
- List my shops and show when their tokens expire.
- Find orders for `MY SHOP US` on `2026-07-18` using Eastern time.
- Compare the shop’s hourly GMV for yesterday with the previous day.

## Similar
- [tiktok-shop-analytics](https://affpapa.org/en/nevibecode/skills/tiktok-shop-analytics.md) — skill · 916 installs
- [tiktok-shop-product-research](https://affpapa.org/en/nevibecode/skills/tiktok-shop-product-research.md) — skill · 1200 installs
- [discovering-tiktok-shop-sellers-by-niche](https://affpapa.org/en/nevibecode/skills/discovering-tiktok-shop-sellers-by-niche.md) — skill · 770 installs
- [saas-metrics](https://affpapa.org/en/nevibecode/skills/saas-metrics.md) — skill · 4900 installs
- [fixed-income-portfolio](https://affpapa.org/en/nevibecode/skills/fixed-income-portfolio.md) — skill · 1800 installs
- [advisor-dashboards](https://affpapa.org/en/nevibecode/skills/advisor-dashboards.md) — skill · 659 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md