remio-harness-plugin
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@remio-harness-plugin What do my notes say about the API design?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 setREMIO_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-pluginDSH 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 |
| Local CLI usage | No |
| Search the knowledge base | No |
| Read a note or supported local file | No |
| RAG answer with citations | No |
| Commercial web search or clean web extraction | No |
| Create, update, delete, attach images, status, permissions | Required |
| Add or remove a note from a collection | Required |
| List or manage indexed folders | Required for changes |
| Publish, refresh, or revoke a public note link | Required |
| Run a remio Agent task | Required |
| Advanced remio syscall escape hatch | Required |
| 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 |
| Absolute path to the remio executable |
|
| CLI invocation timeout |
|
Development and release
npm ci
npm run check
npm test
npm run pack:checkThe 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 toolsremio_askAsk the remio knowledge baseBRead-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 commandADestructive
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 helpBRead-only
Returns the authoritative usage for a locally installed remio CLI command.
Inputs: command.
remio_notesCreate, update, or manage remio notesCDestructive
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 fileARead-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 taskBDestructive
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 baseARead-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_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 syscallADestructive
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 remioARead-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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Remote MCP server for notes, tasks, kanban boards and docs - the Slates agentic workspace
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for AI agents to read, write, and organize notes in a local-first, human-in-the-loop note-taking app.2MIT
- AlicenseCqualityCmaintenanceRead-only MCP server for querying a running Obsidian vault from agentic runtimes, exposing safe Obsidian CLI commands.551MIT
- AlicenseNot gradedqualityBmaintenanceMCP 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.2Apache 2.0
- AlicenseAqualityCmaintenanceMCP 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.13MIT