Server facts
RedNote MCP
Project
- Author
- iFurySt
- Repository
- github.com/iFurySt/RedNote-MCP
- License
- MIT
- Category
- Search & Web Data
Tech
- Runtime / language
- node
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 1,121
- Last commit
- Data as of
Tags
- Cookie Authentication
- Note Search
- Playwright
- Rednote
- Xiaohongshu
Overview
RedNote MCP provides MCP access to Xiaohongshu content. The documented features focus on searching notes by keyword and reading note content from a URL. Authentication is handled through an interactive initialization workflow rather than a supplied API-key variable. The initialization command opens a browser, navigates to the login page, and waits for the user to sign in manually. Successful login saves cookies for subsequent use. The README also mentions a login option within an MCP client, although it does not provide a complete inventory of callable tool names or parameter schemas.
Before starting, users install the Playwright browser environment. The project can then be installed globally through npm or run from a source checkout. Its Cursor examples launch either the installed command or npx with an explicit stdio flag; that flag is required for the documented communication setup. The environment requirements list Node.js 16 or later and npm 7 or later. Cookies are stored in the user's MCP directory, and the README warns that this file contains sensitive information. It recommends refreshing cookies periodically so sessions do not expire. Reading comments by URL is listed as an unfinished feature, not an available capability. Development instructions include dependency installation, a build, tests, and MCP Inspector usage. The README states an MIT license.
Install & configure
Requirements
- Node.js 16 or later
- npm 7 or later
- Playwright browser environment
- A manually initialized Xiaohongshu login session
- An MCP-compatible client
npx rednote-mcp --stdioThe README begins with npx playwright install. Its global setup runs npm install -g rednote-mcp followed by rednote-mcp init for browser login. Cookies are saved to ~/.mcp/rednote/cookies.json. The --stdio flag is required in the documented Cursor configuration. No required environment variables are stated.
Examples are translated from the published configuration. Supply your own credentials and verify requirements in the upstream README. Remote connectors are shown only where a supported configuration format is known.
Config file · macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Use Settings → Developer → Edit Config when available. Do not assume a Linux configuration path; check the client documentation for your platform. Remote servers use the app’s connector flow when supported, not the local stdio file shown here. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"RedNote-MCP": {
"command": "npx",
"args": [
"rednote-mcp",
"--stdio"
],
"env": {}
}
}
}Config file · Project: .cursor/mcp.json
User: ~/.cursor/mcp.json
The project path is relative to the workspace root. The tilde denotes your user home directory. Use Cursor’s MCP settings to confirm which configuration and scope your installed version is reading. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"RedNote-MCP": {
"command": "npx",
"args": [
"rednote-mcp",
"--stdio"
],
"env": {}
}
}
}Config file · Workspace: .vscode/mcp.json
For user scope, use the “MCP: Open User Configuration” command if available. Do not guess a user configuration path across operating systems, profiles, containers, or remote workspaces; check the client documentation. Merge this example with existing settings; do not overwrite unrelated servers.
{
"servers": {
"RedNote-MCP": {
"type": "stdio",
"command": "npx",
"args": [
"rednote-mcp",
"--stdio"
],
"env": {}
}
}
}Config file · macOS/Linux: ~/.codeium/windsurf/mcp_config.json
Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
Open the MCP configuration through Windsurf’s settings when possible to confirm the active file. Paths can differ in managed or future releases; check the client documentation if this location is not present. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"RedNote-MCP": {
"command": "npx",
"args": [
"rednote-mcp",
"--stdio"
],
"env": {}
}
}
}Config file · Project scope: .mcp.json at the repository root
The project file uses mcpServers. For user scope, use claude mcp add --scope user rather than assuming .mcp.json in your home directory is the user configuration. Check the client documentation for managed settings and storage details. Merge this example with existing settings; do not overwrite unrelated servers.
{
"mcpServers": {
"RedNote-MCP": {
"type": "stdio",
"command": "npx",
"args": [
"rednote-mcp",
"--stdio"
],
"env": {}
}
}
}Examples are translated from the published configuration. Supply your own credentials and verify requirements in the upstream README. Remote connectors are shown only where a supported configuration format is known.
Tools
Source: repository README. Tool descriptions are a documented snapshot, not a live capability check.
| Tool | What it does |
|---|---|
| login | Initialize authentication from an MCP client; the README does not detail its parameters. |
Use cases
- Search Xiaohongshu notes by keyword from an assistant.
- Retrieve note content using a known URL.
- Reuse an initialized login session across MCP interactions.
- Inspect protocol requests during local development with MCP Inspector.
Strengths
- Documents both keyword search and direct note-URL access.
- Persists login cookies after interactive authentication.
- Provides global-package and npx client configurations.
Limitations
- Initial login must be completed manually in a browser.
- Saved cookies are sensitive and need periodic renewal.
- Comment retrieval by URL is not yet implemented.
RedNote MCP setup notes
- RedNote MCP's stdio example needs a client that launches local processes.