RemNote

RemNote MCP Server enables Claude Code and other MCP clients to interact with RemNote through the RemNote MCP Bridge plugin. It acts as a bridge between your MCP client and RemNote, allowing you to create, read, update notes, search your knowledge base, and manage journals from your chat or automation workflows.

How to use

You can use this MCP server to connect Claude Code or other MCP clients to RemNote. The server runs locally and exposes an MCP interface that your client can talk to. A typical setup involves configuring Claude Code to reach the local MCP server, enabling the server in Claude Code’s MCP settings, and then issuing commands from Claude Code to manage notes and journals in RemNote.

How to install

Prerequisites: You need Node.js and npm installed on your system. You will install the MCP server locally, build it, and then link it globally so your MCP clients can discover it.

cd ~/Projects/_private/remnote-mcp-server
npm install
npm run build
npm link  # Makes remnote-mcp-server globally available

Additional configuration and usage notes

To connect Claude Code, create a global MCP configuration that points to the RemNote MCP server and sets the RemNote WebSocket port. Then enable this MCP server in Claude Code settings and restart Claude Code to load the server.

Example configuration you would place in Claude Code’s MCP settings:

{
  "remnote": {
    "type": "stdio",
    "command": "remnote-mcp-server",
    "env": {
      "REMNOTE_WS_PORT": "3002"
    }
  }
}

Development and verification

If you want to test locally, start the MCP server in development mode and verify the port is listening and the process is running. From the RemNote side, ensure the RemNote MCP Bridge plugin is active.

# Start MCP server (requires RemNote with MCP Bridge plugin running)
npm start

# Or development mode with auto-reload
npm run dev

Test and verify connection

After Claude Code starts, you can check that the server is running and listening on the configured port, and you can use Claude Code’s status commands to verify the connection.

Available tools

remnote_create_note

Create a new note in RemNote with specified content and location.

remnote_search

Search the RemNote knowledge base with a query and return matching notes.

remnote_read_note

Read and retrieve the content of a note by its identifier.

remnote_update_note

Update the content or metadata of an existing note.

remnote_append_journal

Append content to today's daily document or journal in RemNote.

remnote_status

Check the current connection status between the MCP server and RemNote.