RemNote MCP Server

MCP server that bridges Claude Code (and other MCP clients) to RemNote via the RemNote MCP Bridge plugin.

Installation

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

Usage

With Claude Code

1. Create global MCP configuration at ~/.claude/.mcp.json:

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

2. Enable in settings by adding to ~/.claude/settings.json:

"enabledMcpjsonServers": [
  "remnote"
]

3. Restart Claude Code to load the server.

See CLAUDE_CODE_CONFIG.md for detailed configuration and troubleshooting.

Manual Testing

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

# Or development mode with auto-reload
npm run dev

Testing Server is Running

After Claude Code starts:

# Check process is running
ps aux | grep remnote-mcp-server

# Check WebSocket port is listening
lsof -i :3002

# Test status tool in Claude Code
# In Claude Code chat, type:
# "Use remnote_status to check connection"

Available Tools

• remnote_create_note - Create a new note
• remnote_search - Search the knowledge base
• remnote_read_note - Read a note by ID
• remnote_update_note - Update an existing note
• remnote_append_journal - Append to today's daily document
• remnote_status - Check connection status

Architecture

Claude Code (stdio) ↔ MCP Server (WebSocket Server :3002) ↔ RemNote Plugin ↔ RemNote

Development

npm run dev        # Development with hot reload
npm run typecheck  # Type checking only
npm run build      # Production build