# @sykuang/rednote-mcp [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/sykuang/rednote-mcp  
**GitHub Stars:** 4  
**npm Downloads (last month):** 213  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/sykuang-rednote-mcp

## Description
Xiaohongshu (rednote / 小红书) MCP server for Claude Desktop, Cursor and AI agents — search, read, comment, like and publish notes via npx. Node.js + Playwright port of xiaohongshu-mcp.

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

```json
"mcpServers": {
  "rednote-mcp": {
    "command": "npx",
    "args": ["-y","@sykuang/rednote-mcp"],
    "env": {
      "MCP_STDIO": "",
      "ROD_BROWSER_BIN": "",
      "COOKIES_PATH": "",
      "XHS_PROXY": ""
    }
  }
}
```

**Requires environment variables:** `MCP_STDIO`, `ROD_BROWSER_BIN`, `COOKIES_PATH`, `XHS_PROXY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What @sykuang/rednote-mcp does

@sykuang/rednote-mcp exposes REDNOTE, also known as Xiaohongshu or 小红书, through the Model Context Protocol. It targets the overseas site at rednote.com and provides 13 MCP tools for browsing and interacting with notes. The project is a Node.js and TypeScript port of the Go-based xiaohongshu-mcp, with the site-specific target and browser implementation adapted for REDNOTE.

Available operations include checking login state, obtaining a login QR code, removing stored cookies, listing the home feed, searching notes with filters, reading a note with its comments, and opening a user profile. Agents can also post comments, reply to comments, like or favorite notes, publish image-and-text content, and publish video content.

## How it works

Playwright drives a Chromium browser to interact with rednote.com. The server uses browser responses to handle site data and exposes the resulting operations as MCP tools. It can communicate with an MCP client over standard input and output, or run as an HTTP service. The HTTP deployment exposes API routes under `/api/v1/*` and a Streamable HTTP MCP endpoint at `/mcp`.

The default browser mode is headless. A browser executable can be selected with a command-line option or environment variable. On the first run, the package downloads Chromium, using approximately 170 MB of storage. Login state is handled through cookies: the server can report login status, display a QR code for login, and delete cookies to reset the session.

## Setup and configuration

The simplest installation uses `npx`:

```bash
npx -y @sykuang/rednote-mcp --stdio
```

Use `--stdio` with Claude Desktop, Cursor, or another MCP client. A typical client entry invokes `npx` with `-y`, the package name, and the `--stdio` flag. For a standalone HTTP process, start the package with a port such as `--port :18060`; port 18060 is the documented default for HTTP examples.

Global installation is also supported:

```bash
npm install -g @sykuang/rednote-mcp
rednote-mcp --stdio
```

The source workflow installs dependencies, builds the project, and starts `node dist/main.js`. Docker images and a Docker Compose configuration are available for HTTP deployment. The container examples persist `cookies.json` and allocate 1 GB of shared memory for browser subprocesses.

Configuration options include `MCP_STDIO=1` for stdio mode, `ROD_BROWSER_BIN` for the Chromium path, `COOKIES_PATH` for the cookie file location, and `XHS_PROXY` for an HTTP or HTTPS proxy. The cookie path defaults to `/tmp/cookies.json` when present, otherwise `./cookies.json`. Command-line options also include `--headless`, `--bin`, and `--port`.

## Tools and capabilities

- `check_login_status`, `get_login_qrcode`, and `delete_cookies` manage authentication state.
- `list_feeds` retrieves home-feed content.
- `search_feeds` searches notes with filters.
- `get_feed_detail` returns note details and comments.
- `user_profile` opens a user’s profile.
- `post_comment_to_feed` and `reply_comment_in_feed` add discussion content.
- `like_feed` and `favorite_feed` interact with a note.
- `publish_content` publishes image-and-text content.
- `publish_with_video` publishes video content.

The same package also provides HTTP API routes in addition to MCP access. A Hermes plugin reuses the MCP server and includes the namespaced `rednote:operations` skill.

_Full upstream README: https://allmcps.com/mcp/sykuang-rednote-mcp/readme_