PlugWiki
xiaohongshu-mcp logo

Xiaohongshu MCP Server: Setup for Claude, Cursor and Other Apps

CommunityLocal
GetDockerxpzouying/xiaohongshu-mcpxpzouying/xiaohongshu-mcp
Tools
18
8 read · 10 change
Stars
16.7K
on GitHub
Works in
12
apps
Risk
High
can delete
Auth
None

Lets Claude, Cursor and other assistants search and read Xiaohongshu (RedNote) posts and publish, comment and reply from your account.

This is a community server, not made by Xiaohongshu. You run it yourself with the Docker image or a downloaded program, and it serves MCP on port 18060 of your own computer. It signs in by showing a QR code that you scan with the Xiaohongshu phone app.

The tools act as you. They can publish posts, comment, reply and delete the saved login. The README warns that one account should not be logged in on several web browsers at once. The README is written in Chinese.

Good for

  • Creators who publish and manage posts on Xiaohongshu
  • Marketers researching trends and reading comments on Xiaohongshu
  • Developers building Xiaohongshu workflows with an assistant

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install xiaohongshu MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the xiaohongshu MCP server to Claude Code. Run this command:

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

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Server running (Docker or binary), Logged in with the QR code.

Start the server first. With Docker, run docker compose up -d from the project's docker folder, as the Docker guide describes. Or download the binary for your system from GitHub Releases and run the login program, then the server. The MCP address is http://localhost:18060/mcp. If you set AUTH_TOKEN, add an Authorization: Bearer header in your client.

From the project README. Source.

Tools

  • Checks if you are logged in

    Checks whether the server is logged in to Xiaohongshu.

    Try: “Am I logged in to Xiaohongshu?”

    Read · check_login_status

  • Gets a login QR code

    Returns a QR code image and its timeout, which you scan with the Xiaohongshu phone app to log in.

    Try: “Show me the Xiaohongshu login QR code.”

    Read · get_login_qrcode

  • Logs out by deleting saved cookies

    Deletes the saved cookies file and resets the login. You must log in again afterwards.

    Try: “Log me out of Xiaohongshu.”

    Delete · delete_cookies

  • Lists home feed posts

    Returns the posts on the Xiaohongshu home feed.

    Try: “What is on my Xiaohongshu home feed?”

    Read · list_feeds

  • Searches Xiaohongshu posts

    Searches posts on Xiaohongshu. You must be logged in.

    Try: “Search Xiaohongshu for hiking in Yunnan.”

    Read · search_feeds

  • Reads one post in full

    Returns a post's text, images, author, likes, saves, shares and comments. Video posts include video links and subtitles.

    Try: “Open this post and summarize the comments.”

    Read · get_feed_detail

  • Reads another user's profile

    Returns a user's profile, follower counts and their notes. The saved and liked tabs may be private.

    Try: “Show the profile and latest notes of this user.”

    Read · user_profile

  • Reads your own profile

    Returns your profile, counts and your notes, saved posts or liked posts.

    Try: “Show my Xiaohongshu profile and my latest notes.”

    Read · get_my_profile

  • Publishes an image post

    Publishes an image and text post to your Xiaohongshu account.

    Try: “Publish these three photos with the caption I wrote.”

    Write · publish_content

  • Publishes a video post

    Publishes a video post from a single local video file.

    Try: “Publish this video to Xiaohongshu with a title.”

    Write · publish_with_video

  • Comments on a post

    Posts a comment on a post as your account.

    Try: “Comment on this post that I love the photos.”

    Write · post_comment_to_feed

  • Replies to a comment

    Replies to a specific comment under a post.

    Try: “Reply to the first comment on this post.”

    Write · reply_comment_in_feed

From the official docs

Permissions

high risk · 4 things to watch

High risk

The assistant can publish, comment, reply and like on Xiaohongshu as your account. Try it on a test account first and ask the assistant to confirm each post.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can post and comment as you in public

    Publish, comment, reply and like tools act on your real account. Ask the assistant to show the text before it posts. github.com

  • Automation can get your account flagged

    The README notes that the same account must not be logged in on other web browsers, and that low reach can come from banned words. Use a test account first. github.com

  • The local address has no password by default

    Anyone who can reach port 18060 can use your login. Keep it on localhost, or set AUTH_TOKEN as the README describes. github.com

  • It downloads a headless browser

    The first run downloads a browser of about 150 MB, per the README. Plan for the disk space. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo read-only mode is documented. Publishing, commenting and liking tools are always exposed.
Talks toxiaohongshu.com (through a headless browser)
Sign-in and keysLogin state is saved as cookies in the server's data folder on your computer. An optional AUTH_TOKEN protects the local MCP address, and clients then send a bearer token header.
Scopes

  • Your Xiaohongshu account (QR login)

Questions

Is this an official Xiaohongshu server?

No. It is a community project that drives Xiaohongshu through a browser, not an official API.

What is the Xiaohongshu MCP server URL?

After you start it, the address is http://localhost:18060/mcp. It runs on your own machine, so there is no public URL.

How do I log in?

Ask the assistant for the login QR code and scan it with the Xiaohongshu phone app. The binary version also has a separate login program.

Do I need Docker?

No. The README offers downloadable programs for macOS Apple Silicon, Windows x64 and Linux x64, as well as a Docker image.

Can it post for me?

Yes. It can publish image and video posts, comment, reply and like. Check each post before it goes out.

Is there a simpler version?

The README points to x-mcp, a browser extension version, for people who do not want to set up Docker.

Which tools work without logging in?

Most tools need a logged-in account. The README says search needs a login.

Information

updated Nov 2, 2026

Publisher
Community
Package
xpzouying/xiaohongshu-mcp
Registry
Docker
Transport
Streamable HTTP
Auth
None
License
Apache-2.0
Last commit
Oct 26, 2026
Open issues
59

WebsiteGitHubChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.