Xiaohongshu (Little Red Book) MCP Server

xiaohongshu-mcp-server

A Model Context Protocol (MCP) server for Xiaohongshu (Little Red Book) - China's leading lifestyle social media platform.

Publish image notes, search content, view note details, and manage your account - all through MCP tools that AI assistants can use directly.

How It Works

Uses Playwright to run a headless Chromium browser that:

1. Loads your XHS session cookies
2. Generates authentic API signatures via the XHS web app's built-in signing function
3. Makes API calls through the browser's network context (bypasses anti-bot detection)
4. Uploads images directly to XHS CDN

No browser automation of UI elements - all interactions go through XHS's internal API.

Tools

Installation

pip install xiaohongshu-mcp-serverplaywright install chromium

For QR code image generation (optional):

pip install "xiaohongshu-mcp[qrcode]"

Quick Start

1. Start the server

HTTP mode (for Claude Code, Cursor, etc.):

xhs-mcp --transport http --port 18060

stdio mode (for Claude Desktop):

xhs-mcp --transport stdio

2. Login

Call the get_login_qrcode tool, scan the QR code with the Xiaohongshu app, then call check_qrcode_status with the returned qr_id and code. Cookies are saved to ~/.xhs-mcp/cookies.json and persist across restarts.

3. Use

Ask your AI assistant to publish a note, search for content, etc.

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{  "mcpServers": {    "xhs-mcp": {      "command": "xhs-mcp",      "args": ["--transport", "stdio"]    }  }}

Claude Code

claude mcp add xhs-mcp --transport http http://localhost:18060/mcp

Then start the server: xhs-mcp

As a LaunchAgent (macOS auto-start)

Create ~/Library/LaunchAgents/com.xhs-mcp.plist:

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>    <key>Label</key>    <string>com.xhs-mcp</string>    <key>ProgramArguments</key>    <array>        <string>/path/to/your/venv/bin/xhs-mcp</string>    </array>    <key>RunAtLoad</key>    <true/>    <key>KeepAlive</key>    <true/>    <key>StandardOutPath</key>    <string>/tmp/xhs-mcp.log</string>    <key>StandardErrorPath</key>    <string>/tmp/xhs-mcp.err</string></dict></plist>

launchctl load ~/Library/LaunchAgents/com.xhs-mcp.plist

Example: Publish a Note

# Via MCP tool callpublish_content(    title="Hello XHS!",    content="My first post published via MCP.",    images=["/path/to/photo.jpg"],    tags=["MCP", "AI"])

Requirements

• Python 3.12+
• Chromium (installed via playwright install chromium)
• A Xiaohongshu account

License

MIT