Skip to main content
Glama
remio-harness-plugin

remio-harness-plugin

by ShakeLv

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

Tool

Purpose

Confirmation

remio_help

Local CLI usage

No

remio_search_notes

Search the knowledge base

No

remio_read

Read a note or supported local file

No

remio_ask

RAG answer with citations

No

remio_web

Commercial web search or clean web extraction

No

remio_notes

Create, update, delete, attach images, status, permissions

Required

remio_collections

Add or remove a note from a collection

Required

remio_sync_folders

List or manage indexed folders

Required for changes

remio_share

Publish, refresh, or revoke a public note link

Required

remio_run_agent

Run a remio Agent task

Required

remio_syscall

Advanced remio syscall escape hatch

Required

remio_cli

Full CLI compatibility entry point

Required for changes

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

Variable

Meaning

Default

REMIO_CLI_PATH

Absolute path to the remio executable

remio

REMIO_CLI_TIMEOUT_MS

CLI invocation timeout

120000

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

Available Tools

12 tools
remio_askAsk the remio knowledge baseB
Read-only

Answers a question from the remio knowledge base and includes note citations when available.

Inputs: question (required), mode, limit.

remio_cliRun an advanced remio CLI commandA
Destructive

Compatibility entry point for every remio CLI command: search_notes, read_note, read_file, add_sync_folder, list_sync_folders, pause_sync_folder, resume_sync_folder, remove_sync_folder, create_note, update_note, attach_image, add_note_to_collection, remove_note_from_collection, delete_note, update_note_restrictions, share_note, unshare_note, set_note_status, create_people_note, rag, web_search, web_get, run_agent, syscall. Prefer the structured tools above. State-changing commands require confirm: true.

Inputs: command (required), args, pretty, confirm.

remio_collectionsManage remio note collectionsA

Adds or removes a note from a collection. Adding by collection title creates that collection when it does not exist.

Inputs: action (required), note_id (required), confirm, collection_id, +1 more.

remio_helpGet remio CLI helpB
Read-only

Returns the authoritative usage for a locally installed remio CLI command.

Inputs: command.

remio_notesCreate, update, or manage remio notesC
Destructive

Changes notes, people notes, note images, permissions, or status. Requires explicit confirmation for every call.

Inputs: action (required), edits, email, later, +15 more.

remio_readRead a remio note or local fileA
Read-only

Reads a remio note by note ID, or converts a local supported file to markdown. Do not read unrelated local files.

Inputs: source (required), id_or_path (required), limit, format, +1 more.

remio_run_agentRun a remio Agent taskB
Destructive

Runs a remio Agent with a project directory. It may invoke the requested capabilities, so explicit confirmation is required.

Inputs: prompt (required), project_dir (required), model, confirm, +4 more.

remio_search_notesSearch the remio knowledge baseA
Read-only

Search notes, files, email, Slack, meetings, and other remio knowledge. Prefer this before reading a note by ID.

Inputs: ids, sort, type, later, +11 more.

remio_sharePublish or revoke a public remio note linkA
Destructive

Publishes a note to a public URL, refreshes an existing public URL, or revokes public access. Requires explicit confirmation.

Inputs: action (required), note_id (required), confirm.

remio_sync_foldersManage remio sync foldersB

Lists or changes folders that remio indexes. Changes require explicit confirmation; removing a folder preserves already-created notes.

Inputs: action (required), path, confirm.

remio_syscallRun an advanced remio syscallA
Destructive

Advanced escape hatch for a remio syscall not represented above. It can have arbitrary side effects and always requires explicit confirmation.

Inputs: action (required), confirm, payload.

remio_webSearch or fetch web content with remioA
Read-only

Uses remio's configured high-quality web search or clean web-page extraction. Fetching never creates a remio note.

Inputs: action (required), url, count, media, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 12 tools

    Disambiguation3/5

    Most tools have distinct purposes, but remio_search_notes, remio_ask, and remio_web all involve retrieving information, and remio_cli/remio_syscall are catch-alls that overlap with every other tool. The descriptions help clarify, but some ambiguity remains.

    Naming Consistency4/5

    All tools share the remio_ prefix and most use verb-based names (help, search_notes, read, ask, share, run_agent), though a few are nouns (notes, collections, web). The overall pattern is consistent and predictable.

    Tool Count5/5

    Twelve tools is well within the optimal range and appropriate for a knowledge-management integration. Each tool covers a distinct capability, with the CLI and syscall tools providing fallbacks.

    Completeness5/5

    The surface covers searching, reading, asking, web access, note creation/updating, collections, folder sync, sharing, and agent execution. The remio_cli tool exposes every CLI command, so there are no obvious dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for AI agents to read, write, and organize notes in a local-first, human-in-the-loop note-taking app.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server that wraps the nb CLI for LLM-friendly note-taking, enabling creation, reading, updating, deleting, and searching notes, todos, bookmarks, and folders in notebooks.
      2
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for managing a local, domain-agnostic knowledge base using Markdown notes with frontmatter. Enables AI agents to capture, read, search, link, and maintain notes with atomic writes and privacy controls.
      13
      MIT