remio Harness Plugin

MCP server for using a local remio knowledge base from DeepSeek Harness and any MCP-compatible agent client.

It exposes remio search, reading, RAG, web retrieval, note management, collection management, sync-folder management, public sharing, agent execution, and advanced syscalls. It invokes the local remio executable directly with argument arrays; it never opens a shell.

Requirements

• Node.js 20 or later

• pnpm (required by dsh plugin)

• remio desktop app installed and running

• remio CLI available on PATH (or set REMIO_CLI_PATH)

Related MCP server: Obsidian Readonly MCP

Install

After the package is published, install it in a DeepSeek Harness profile:

dsh plugin --profile standard add @remio/harness-plugin

DSH loads the bundle automatically and exposes the remio MCP tools under the mcp__remio__ namespace, for example mcp__remio__remio_search_notes and mcp__remio__remio_ask.

The same published package can also be used directly by any MCP-compatible client:

{
  "mcpServers": {
    "remio": {
      "command": "npx",
      "args": ["-y", "@remio/harness-plugin"]
    }
  }
}

For local development:

npm install
npm run build
node dist/index.js

{
  "mcpServers": {
    "remio": {
      "command": "node",
      "args": ["/absolute/path/to/remio-harness-plugin/dist/index.js"]
    }
  }
}

Tools

The structured tools are the recommended interface. remio_cli is retained for a remio CLI capability that has not yet been promoted into a dedicated structured tool.

Safety model

The server uses MCP tool annotations so compatible clients can show appropriate risk prompts. It additionally refuses every state-changing call unless the caller sends confirm: true after obtaining explicit user approval.

The server does not bypass remio authorization. Existing remio restrictions, passwords, session-scoped write checks, and public-sharing behavior remain enforced by the local remio app.

Configuration

Development and release

npm ci
npm run check
npm test
npm run pack:check

The CI workflow verifies Node.js 20, 22, and 24. Before the first public release, add the canonical public repository URL to package.json, publish under the @remio npm organization, and submit the npm package plus repository link to the applicable Harness plugin directory. DSH detects the package as a native profile bundle through its dsh.bundle.patch manifest field.

The DSH bundle has been verified against @deepseek-ai/dsh@0.1.0-rc.6: a clean profile installed the package successfully and its composed configuration included the remio-mcp bridge row.

License

MIT