# Xiaohongshu (Little Red Book) MCP Server [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/shanyang-me/xhs-mcp  
**GitHub Stars:** 2  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/xiaohongshu-little-red-book-mcp-server

## Description
Publish, search, and manage Xiaohongshu (Little Red Book) content via MCP tools.

## Tools
Capabilities this server exposes over MCP:

- **check_login_status** — Check if you're logged in
- **get_login_qrcode** — Generate QR code for login
- **check_qrcode_status** — Poll QR scan status & save session
- **reload_cookies** — Reload cookies from disk
- **publish_content** — Publish an image note with title, text, images, and tags
- **search_feeds** — Search XHS notes by keyword
- **get_feed_detail** — Get full details of a note
- **user_profile** — Get user profile information

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "xiaohongshu-little-red-book-mcp-server": {
    "command": "uvx",
    "args": ["xiaohongshu-mcp-server"]
  }
}
```

## Documentation

## What Xiaohongshu (Little Red Book) MCP Server MCP server does

Xiaohongshu (Little Red Book) MCP Server MCP server exposes account and content operations from Xiaohongshu as MCP tools. It supports QR-code login, session restoration, image-note publishing, keyword search, note inspection, and profile lookup. Publishing accepts a title, text, image paths, and tags; search and detail tools support researching existing notes.

The server is intended for use with an AI assistant that can call MCP tools. It can run locally over stdio or as an HTTP MCP endpoint, so the connection method depends on the client you are using.

## How it works

The implementation starts a headless Chromium browser through Playwright. It loads Xiaohongshu cookies from the local session, uses the web application’s signing function to create API signatures, and makes requests through the browser’s network context. Image files are uploaded to the Xiaohongshu CDN.

The server does not automate visible page controls. Its interactions use Xiaohongshu’s internal API through the browser context. This approach requires Chromium to be installed separately with Playwright.

## Setup and configuration

Install the Python package and browser dependency:

```bash
pip install xiaohongshu-mcp-server
playwright install chromium
```

Python 3.12 or newer and a Xiaohongshu account are required. QR-code image generation is optional and can be installed with `pip install "xiaohongshu-mcp[qrcode]"`.

Start stdio mode for a local desktop client:

```bash
xhs-mcp --transport stdio
```

For clients using HTTP, start the server on port 18060:

```bash
xhs-mcp --transport http --port 18060
```

To authenticate, call `get_login_qrcode`, scan the returned code in the Xiaohongshu app, and pass its `qr_id` and `code` to `check_qrcode_status`. The resulting cookies are saved at `~/.xhs-mcp/cookies.json` and can be reused after restarts. Claude Desktop can launch the stdio command from its MCP configuration, while Claude Code can connect to `http://localhost:18060/mcp`.

## Tools and capabilities

Xiaohongshu (Little Red Book) MCP Server MCP server provides these tools:

- `check_login_status` checks whether the current session is authenticated.
- `get_login_qrcode` creates a QR code login request.
- `check_qrcode_status` checks a QR scan and saves the resulting session.
- `reload_cookies` reloads cookies stored on disk.
- `publish_content` publishes an image note with a title, text, images, and tags.
- `search_feeds` searches Xiaohongshu notes by keyword.
- `get_feed_detail` retrieves full details for a note.
- `user_profile` returns user profile information.

These operations cover authentication, publishing, content discovery, note inspection, and basic account lookup.

## Limitations and notes

The server requires an active Xiaohongshu account, Python 3.12+, and a Chromium installation. Login state is stored locally in `~/.xhs-mcp/cookies.json`, so the runtime needs access to that path. Publishing is documented for image notes; the provided tools do not describe video publishing, commenting, liking, following, or other account actions. The optional QR-code package is only needed when QR code image generation requires it.

_Full upstream README: https://allmcps.com/mcp/xiaohongshu-little-red-book-mcp-server/readme_