Log inSubmit server
Rednote MCP logo

Rednote MCP

by @sykuang

Connects AI agents to rednote.com for searching, reading, engaging with, and publishing Xiaohongshu content.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Rednote MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "sykuang-rednote-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sykuang/rednote-mcp"
      ],
      "env": {
        "MCP_STDIO": "YOUR_VALUE_HERE",
        "ROD_BROWSER_BIN": "YOUR_VALUE_HERE",
        "COOKIES_PATH": "YOUR_VALUE_HERE",
        "XHS_PROXY": "YOUR_VALUE_HERE"
      }
    }
  }
}

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

Values are written into the snippet above so you can paste it as is. They never leave your browser.

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.

npx -y @sykuang/rednote-mcp

No response to 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 1d ago.

Overview

@sykuang/rednote-mcp connects MCP clients and AI agents to the overseas REDNOTE site, rednote.com. Its 13 tools cover login handling, feed discovery, note details, profiles, comments, likes, favorites, and text, image, or video publishing. It runs through Node.js, TypeScript, and Playwright, with stdio for MCP clients and optional HTTP or Streamable HTTP endpoints. Reach for it when an agent needs to automate REDNOTE workflows rather than only retrieve public content.

Use cases

  • Search REDNOTE notes with filters
  • Read note details and comments
  • Post comments and replies
  • Like or favorite notes
  • Publish image, text, or video content

Key features

  • 13 MCP tools for REDNOTE operations
  • Playwright-driven Chromium browser automation
  • Stdio and Streamable HTTP MCP modes
  • HTTP API under /api/v1/*
  • Cookie-based login management
  • Image-text and video publishing

Security & health

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

ActiveLast checked 1d ago

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · @sykuang/rednote-mcp (npm)

Adoption & maintenance

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

GitHub stars4Stargazers on the source repository.
npm downloads213Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.

How Rednote MCP works

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:

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

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

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

@sykuang/rednote-mcp is an MCP server that connects AI agents to rednote.com, the overseas Xiaohongshu platform. Its main tools search feeds, read notes and comments, inspect profiles, post or reply to comments, like or favorite notes, manage login cookies, and publish image-text or video content.

Install it with npx by running `npx -y @sykuang/rednote-mcp --stdio`. Add that command and its arguments to an MCP client configuration, or install globally with `npm install -g @sykuang/rednote-mcp` and run `rednote-mcp --stdio`. The first run downloads Chromium.

Yes, it works with Cursor through stdio mode. Configure Cursor to run `npx` with `-y`, `@sykuang/rednote-mcp`, and `--stdio` as the arguments.

Run `npx @sykuang/rednote-mcp --port :18060` to start the HTTP service. The package exposes API routes under `/api/v1/*` and a Streamable HTTP MCP endpoint at `/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 PreviewRednote MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/sykuang-rednote-mcp?style=directory)](https://allmcps.com/mcp/sykuang-rednote-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/sykuang-rednote-mcp"><img src="https://allmcps.com/api/badge/sykuang-rednote-mcp?style=directory" alt="Rednote MCP on AllMCPs" /></a>