RemNote MCP Server

What RemNote MCP Server does

RemNote MCP Server is an npm package that connects AI agents, local scripts and coding tools to a RemNote knowledge base through the Model Context Protocol. It works with a separate RemNote Automation Bridge plugin that runs in the RemNote browser or desktop app and exposes the RemNote API over WebSocket.

The package provides three commands: remnote-mcp-server for MCP HTTP clients, remnote-mcp-stdio for clients that cannot use Streamable HTTP, and remnote-cli for command-line workflows. Through them an agent can create notes, hierarchical Markdown trees and RemNote-native flashcards, search and read the knowledge base, update existing notes, and maintain a daily journal. For OpenClaw and Hermes agents, the README points to remnote-cli and a bundled RemNote CLI skill at skills/remnote/SKILL.md, with the server kept running locally on port 3001 and the plugin socket on 3002.

Key features

• MCP HTTP server on port 3001 with a WebSocket link to the RemNote plugin on 3002
• remnote-mcp-stdio proxy for clients without Streamable HTTP support
• remnote-cli for scripts, coding tools and command-driven agents
• Create notes, Markdown trees and RemNote-native flashcards
• Search, read and update notes and maintain a daily journal
• Bundled RemNote CLI skill for OpenClaw and Hermes workflows

When to use it

• Let a Hermes agent search and add to your RemNote notes from the command line
• Create flashcards in RemNote from a conversation with an agent
• Append to your daily journal from a script

Who it is for: RemNote users who want AI agents or scripts to read and write their knowledge base.

How it fits with Hermes Agent

Hermes workflows are named alongside OpenClaw as users of remnote-cli and the bundled skill; the server itself is agent-neutral MCP.

Requirements: The RemNote Automation Bridge plugin in RemNote, with a bridge and server version on the same 0.x minor line

Note: It needs the separate RemNote Automation Bridge plugin, and mismatched plugin and server versions can disconnect with a 1008 compatibility message.

FAQ