remnote-mcp-server
Advanced tools
MCP server and CLI package that bridges AI agents, local scripts, and coding harnesses to RemNote via the RemNote Automation Bridge plugin.
If you run into any issues, please report them here.
Connection issue? Check the RemNote plugin first. The RemNote Marketplace may show multiple similarly named
MCP Bridgeplugins. For this server, install the official MCP/OpenClaw Automation Bridge plugin by Robert Spiegel and keep it on the same0.xminor version line asremnote-mcp-server(for example0.14.xwith0.14.x). Wrong plugin flavors or incompatible marketplace copies can connect briefly and then disconnect with a1008compatibility message. See the related upstream marketplace confusion report: quentintou/remnote-mcp-bridge#8.
The RemNote MCP Server enables AI assistants like Claude Code to interact directly with your RemNote knowledge base
through the Model Context Protocol (MCP). The same npm package also provides remnote-cli, a command-line MCP client
for local scripts and coding harnesses, and remnote-mcp-stdio, a stdio MCP proxy for clients that cannot consume
Streamable HTTP directly. Create notes, hierarchical markdown trees, and RemNote-native flashcards; search and read
your knowledge base; update existing notes; and maintain your daily journal through MCP tools or shell commands.
See AI agent examples in action with RemNote: View Demo →
This system consists of two separate runtime components that work together:
remnote-mcp-server for MCP
HTTP clients, remnote-mcp-stdio for stdio MCP clients, and remnote-cli for command-line workflowsThe remnote-cli and remnote-mcp-stdio commands are not second RemNote-facing servers. They call the MCP endpoint
exposed by remnote-mcp-server.
For the detailed bridge connection lifecycle, retry phases, and wake-up triggers, use the bridge repo as the source of truth: Connection Lifecycle Guide.
AI agents (HTTP) -> MCP HTTP Server :3001 -> WebSocket Server :3002 -> RemNote Plugin -> RemNote
AI agents (stdio) -> remnote-mcp-stdio -> MCP HTTP Server :3001 -> WebSocket Server :3002 -> RemNote Plugin -> RemNote
CLI commands -> remnote-cli -> MCP HTTP Server :3001 -> WebSocket Server :3002 -> RemNote Plugin -> RemNote
The server acts as a bridge:
remnote-mcp-stdio as a local stdio MCP proxy for clients that need stdio transportremnote-cli as a bundled command-line MCP client for local automationMulti-Agent Support: Multiple AI agents can connect simultaneously to the same RemNote knowledge base. Each agent gets its own MCP session while sharing the WebSocket bridge.
Remote Access: By default, the server binds to localhost (127.0.0.1) for local AI agents. Claude Desktop and Claude Cowork can use the bundled local MCPB extension when desktop extensions are enabled. Cloud-based clients, web/mobile surfaces, and managed Claude deployments without local MCPB require remote access—use tunneling tools like ngrok to expose the HTTP endpoint securely. The WebSocket connection always stays local for security. See Remote Access Guide for setup.
Version compatibility (
0.xsemver): install aremnote-mcp-serverversion compatible with your installed RemNote Automation Bridge plugin version. See the Bridge / Consumer Version Compatibility Guide.
npm install -g remnote-mcp-server
The package installs these commands:
remnote-mcp-server --version
remnote-cli --version
remnote-mcp-stdio --version
Install the official MCP/OpenClaw Automation Bridge plugin in your
RemNote app. If installing from the RemNote Marketplace, verify the plugin name and author; similarly named
MCP Bridge variants may be incompatible with this server and cause connection loops or 1008 disconnects. Configure
the plugin to connect to ws://127.0.0.1:3002.
remnote-mcp-server
Expected output:
RemNote MCP Server v0.14.1 listening { wsPort: 3002, httpPort: 3001 }
Keep this terminal running.
remnote-cli skill setupremnote-mcp-stdio0.x semver)| Tool | Description |
|---|---|
remnote_create_note | Create notes, markdown trees, or flashcards with title, content, parent, and tags |
remnote_search | Search knowledge base with full-text search and parent-context metadata; tags remain optional and SDK-limited |
remnote_search_by_tag | Search by tag with ancestor-context resolution |
remnote_read_note | Read note by ID with metadata and markdown or structured content; readable tags remain SDK-limited |
remnote_update_note | Update title, append/replace content, or modify tags |
remnote_append_journal | Append hierarchical content to today's daily document |
remnote_read_table | Read Advanced Table columns, rows, and typed property metadata |
remnote_get_playbook | Get recommended MCP usage/navigation playbook |
remnote_status | Check connection status and statistics |
Tools that declare an outputSchema return MCP structuredContent plus a JSON content text block for compatibility.
See the MCP tools specification for the
protocol contract.
The server uses @modelcontextprotocol/sdk and supports current MCP protocol negotiation, including 2025-11-25.
Do not confuse MCP protocol versions with remnote-mcp-server or bridge plugin package versions; package versions use
0.x semver and should usually match by minor line.
See the Tools Reference for detailed usage and examples.
remnote-mcp-stdioremnote-cliCreate notes:
Create a note about "Project Ideas" with content:
- AI-powered note taking
- Personal knowledge management
Search:
Search my RemNote for notes about "machine learning"
Update notes:
Add a tag "important" to note abc123
Journal entries:
Add to my journal: "Completed the RemNote MCP integration"
See the Tools Reference for more examples.
REMNOTE_HTTP_PORT - HTTP MCP server port (default: 3001)REMNOTE_HTTP_HOST - HTTP server bind address (default: 127.0.0.1)REMNOTE_WS_PORT - WebSocket server port (default: 3002)remnote-mcp-server --http-port 3003 --ws-port 3004
After changing ports, update your MCP client configuration and RemNote plugin settings.
See CLI Options Reference for all options.
Server won't start:
lsof -i :3001 and lsof -i :3002which remnote-mcp-serverPlugin won't connect:
ws://127.0.0.1:3002lsof -i :3002Tools not appearing:
claude mcp list0.x minor versions may break); see the
Bridge / Consumer Version Compatibility
GuideSee the Troubleshooting Guide for detailed solutions.
Development setup:
Version compatibility tip: when testing against a local or marketplace-installed bridge plugin, use a server checkout/tag compatible with that bridge plugin version (see the Bridge / Consumer Version Compatibility Guide).
git clone https://github.com/robert7/remnote-mcp-server.git
cd remnote-mcp-server
./link-cli.sh
# Later, remove the local links for package executables:
./unlink-cli.sh
Development workflow:
npm run dev # Watch mode with hot reload
npm test # Run test suite
./code-quality.sh # Run all quality checks
See the Development Setup Guide for complete instructions.
Pull requests that affect bridge-consumer behavior should follow the shared PR rules in the bridge repo: Pull Request Guide. In particular, keep bridge and server-package behavior aligned for shared functionality changes.
For the canonical workflow for updating and running shared live integration coverage, see the Integration Testing Guide.
MIT
FAQs
MCP server bridge for RemNote knowledge base
The npm package remnote-mcp-server receives a total of 59 weekly downloads. As such, remnote-mcp-server popularity was classified as not popular.
We found that remnote-mcp-server demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Cursor removed a malicious Claude Code 2.1.313 extension from its marketplace. Socket examines registry records and the initial claims about its distribution.
Security News
An OpenCode user faced harassment after reporting a free AI usage loophole, drawing a bitter backlash in a GitHub thread that has since been deleted.
Threat Research
/Security News
319 browser extensions installed by 13.4 million users hijack searches, capture queries, and collect referral payments from Yahoo and Bing.