Log inSubmit server
Xiaohongshu (Little Red Book) MCP Server logo

Xiaohongshu (Little Red Book) MCP Server

Publish, search, and inspect Xiaohongshu content through MCP tools backed by a Playwright Chromium session.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Xiaohongshu (Little Red Book) MCP Server

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": {
    "xiaohongshu-little-red-book-mcp-server": {
      "command": "uvx",
      "args": [
        "xiaohongshu-mcp-server"
      ]
    }
  }
}

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

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx xiaohongshu-mcp-server

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 23d ago.

Overview

Xiaohongshu (Little Red Book) MCP Server MCP server connects AI assistants to Xiaohongshu through tools for login, publishing image notes, searching feeds, viewing note details, and reading profiles. It runs Playwright with Chromium, uses stored session cookies, and sends requests through the browser network context using Xiaohongshu’s signing function. Reach for it when an assistant needs to manage or research Xiaohongshu content, provided you have a Xiaohongshu account and can run Python 3.12+ with Chromium.

Use cases

  • Publish image notes with titles, text, images, and tags
  • Search Xiaohongshu notes by keyword
  • Retrieve full details for Xiaohongshu notes
  • Check login state and restore saved cookies
  • Look up Xiaohongshu user profiles

Key features

  • QR-code account login
  • Persistent cookie sessions
  • Image-note publishing
  • Keyword feed search
  • Note detail retrieval
  • User profile lookup

Tools8

What Xiaohongshu (Little Red Book) MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~92 tokens of context

Security & health

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

ActiveLast checked 2d ago

Recent health check succeeded.

11/11 checks healthy over the last 55d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · xiaohongshu-mcp-server (PyPI)

Adoption & maintenance

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

GitHub stars2Stargazers on the source repository.
Last commit8mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed8Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Xiaohongshu (Little Red Book) MCP Server works

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:

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

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 Xiaohongshu (Little Red Book) MCP Server

Xiaohongshu (Little Red Book) MCP Server is an MCP server that connects AI assistants to Xiaohongshu through Playwright and Chromium. Its main tools handle QR-code login, cookie sessions, image-note publishing, feed search, note details, and user profile lookup. It supports stdio and HTTP transport modes.

Install it with pip, then install Chromium with Playwright. Run `pip install xiaohongshu-mcp-server` followed by `playwright install chromium`. The server requires Python 3.12 or newer and a Xiaohongshu account.

Log in by calling `get_login_qrcode`, scanning the returned QR code in the Xiaohongshu app, and calling `check_qrcode_status` with the returned `qr_id` and `code`. Cookies are saved to `~/.xhs-mcp/cookies.json` for later restarts.

Yes, it works with Cursor through HTTP transport. Start `xhs-mcp --transport http --port 18060`, then configure Cursor to connect to the MCP endpoint at `http://localhost:18060/mcp`.

Related MCP servers

All in Social Media 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 PreviewXiaohongshu (Little Red Book) MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/xiaohongshu-little-red-book-mcp-server?style=directory)](https://allmcps.com/mcp/xiaohongshu-little-red-book-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/xiaohongshu-little-red-book-mcp-server"><img src="https://allmcps.com/api/badge/xiaohongshu-little-red-book-mcp-server?style=directory" alt="Xiaohongshu (Little Red Book) MCP Server on AllMCPs" /></a>