# mcp-shopee

Brings Shopee Partner API v2 to coding agents. It automates inventory updates, order tracking, returns processing, and chat communication.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/ecommerce/shopee
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-shopee

## What it does

This server registers 22 tools targeting the Shopee Open Platform. It lets agents inspect orders in batches of up to 50 items, manage listing prices, and create new catalog entries. Tools also cover shipment documents, discount creation, and buyer messaging.

Requests require HMAC-SHA256 signatures, which the package calculates automatically before sending HTTP calls. Running the server requires your partner credentials, shop ID, and an active access token. Because merchant access tokens expire every 4 hours, token refresh via the 30-day token must run in an external background service.

The package is currently at `0.1.0-alpha.1`. Checking delivery channel fields and `ship_order` payloads against current API documentation is necessary before processing live store dispatches.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SHOPEE_PARTNER_ID`, `SHOPEE_PARTNER_KEY`, `SHOPEE_ACCESS_TOKEN`, `SHOPEE_SHOP_ID`, `SHOPEE_ENV` — 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 SHOPEE_PARTNER_ID=<SHOPEE_PARTNER_ID> --env SHOPEE_PARTNER_KEY=<SHOPEE_PARTNER_KEY> --env SHOPEE_ACCESS_TOKEN=<SHOPEE_ACCESS_TOKEN> --env SHOPEE_SHOP_ID=<SHOPEE_SHOP_ID> --env SHOPEE_ENV=<SHOPEE_ENV> --transport stdio shopee -- npx -y @codespar/mcp-shopee
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add shopee --env SHOPEE_PARTNER_ID=<SHOPEE_PARTNER_ID> --env SHOPEE_PARTNER_KEY=<SHOPEE_PARTNER_KEY> --env SHOPEE_ACCESS_TOKEN=<SHOPEE_ACCESS_TOKEN> --env SHOPEE_SHOP_ID=<SHOPEE_SHOP_ID> --env SHOPEE_ENV=<SHOPEE_ENV> -- npx -y @codespar/mcp-shopee
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "shopee": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-shopee"
            ],
            "env": {
                "SHOPEE_PARTNER_ID": "<SHOPEE_PARTNER_ID>",
                "SHOPEE_PARTNER_KEY": "<SHOPEE_PARTNER_KEY>",
                "SHOPEE_ACCESS_TOKEN": "<SHOPEE_ACCESS_TOKEN>",
                "SHOPEE_SHOP_ID": "<SHOPEE_SHOP_ID>",
                "SHOPEE_ENV": "<SHOPEE_ENV>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "shopee": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-shopee"
            ],
            "env": {
                "SHOPEE_PARTNER_ID": "<SHOPEE_PARTNER_ID>",
                "SHOPEE_PARTNER_KEY": "<SHOPEE_PARTNER_KEY>",
                "SHOPEE_ACCESS_TOKEN": "<SHOPEE_ACCESS_TOKEN>",
                "SHOPEE_SHOP_ID": "<SHOPEE_SHOP_ID>",
                "SHOPEE_ENV": "<SHOPEE_ENV>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SHOPEE_PARTNER_ID=<SHOPEE_PARTNER_ID> -e SHOPEE_PARTNER_KEY=<SHOPEE_PARTNER_KEY> -e SHOPEE_ACCESS_TOKEN=<SHOPEE_ACCESS_TOKEN> -e SHOPEE_SHOP_ID=<SHOPEE_SHOP_ID> -e SHOPEE_ENV=<SHOPEE_ENV> shopee npx -y @codespar/mcp-shopee
```
Replace <…> with your own values

## When to use it
- pull pending orders across custom time intervals
- adjust stock levels and item prices directly
- download air waybill PDF documents for shipping
- handle buyer return requests and approve resolutions

## Example prompts
- Check recent unfulfilled orders from today
- Update the stock count for item 123456 to 25 units
- Fetch the air waybill PDF for order 240501ABC

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
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