Skip to main content
Glama
robert7

RemNote MCP Server

by robert7
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

RemNote MCP Server

Status License CI codecov

MCP server that bridges AI agents (e.g. Claude Code) to RemNote via the RemNote MCP Bridge plugin.

This is a working proof-of-concept/experimental solution. It "works on my machine" — you're invited to test it and report any bugs or issues.

What is This?

The RemNote MCP Server enables AI assistants like Claude Code to interact directly with your RemNote knowledge base through the Model Context Protocol (MCP). Create notes, search your knowledge base, update existing notes, and maintain your daily journal—all through conversational commands.

Demo

See AI agent examples in action with RemNote: View Demo →

Two-Component Architecture

This system consists of two separate components that work together:

  1. RemNote MCP Bridge - A RemNote plugin that runs in your browser or RemNote desktop app and exposes RemNote API functionality via WebSocket

  2. RemNote MCP Server (this project) - A standalone server that connects your AI assistant to the bridge using MCP protocol

Both components are required for AI integration with RemNote.

How It Works

AI agents (HTTP) ↔ MCP HTTP Server :3001 ↔ WebSocket Server :3002 ↔ RemNote Plugin ↔ RemNote

The server acts as a bridge:

  • Communicates with AI agents via Streamable HTTP transport (MCP protocol) - supports both local and remote access

  • HTTP server (port 3001) manages MCP sessions for multiple concurrent agents

  • WebSocket server (port 3002) connects to the RemNote browser plugin

  • Translates MCP tool calls into RemNote API actions

Multi-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. Cloud-based services like Claude Cowork 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.

Features

  • Create Notes - Create new notes with optional parent hierarchy and tags

  • Search Knowledge Base - Full-text search with configurable result limits

  • Read Notes - Retrieve note content with configurable child depth

  • Update Notes - Modify titles, append content, add/remove tags

  • Journal Entries - Append timestamped entries to daily documents

  • Connection Status - Check server and plugin connection health

Quick Start

1. Install the Server

npm install -g remnote-mcp-server

2. Install the RemNote Plugin

Install the RemNote MCP Bridge plugin in your RemNote app. Currently available from GitHub; registration in the RemNote marketplace is pending approval. Configure the plugin to connect to ws://127.0.0.1:3002.

3. Start the Server

remnote-mcp-server

Expected output:

RemNote MCP Server v0.2.1 listening { wsPort: 3002, httpPort: 3001 }

Keep this terminal running.

4. Configure Your AI Client

Documentation

Getting Started

Usage

Help & Advanced

Development

Available MCP Tools

Tool

Description

remnote_create_note

Create new notes with optional parent and tags

remnote_search

Search knowledge base with full-text search

remnote_read_note

Read note by ID with configurable depth

remnote_update_note

Update title, append content, or modify tags

remnote_append_journal

Append to today's daily document

remnote_status

Check connection status and statistics

See the Tools Reference for detailed usage and examples.

Supported AI Clients

Example Usage

Create 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.

Configuration

Environment Variables

  • 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)

Custom Ports

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.

Troubleshooting

Server won't start:

  • Check ports aren't in use: lsof -i :3001 and lsof -i :3002

  • Verify installation: which remnote-mcp-server

Plugin won't connect:

  • Verify plugin settings: WebSocket URL ws://127.0.0.1:3002

  • Check server is running: lsof -i :3002

Tools not appearing:

  • Verify configuration: claude mcp list

  • Restart Claude Code completely

See the Troubleshooting Guide for detailed solutions.

Contributing & Development

Development setup:

git clone https://github.com/robert7/remnote-mcp-server.git cd remnote-mcp-server npm install npm run build npm link

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.

Related Projects

License

MIT

Links

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/robert7/remnote-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server