PluginBench
MCP Server
Active
AGPL-3.0

io.github.Ranork/remnus MCP Server

io.github.Ranork/remnus

Open-source MCP-native workspace: read and write pages, databases, and kanban boards for AI agents and humans.

RepositoryRegistry
How to choose

What this kind of tool is for

  • Create, search, or update items in a notes, docs, or tasks service from your agent.
  • Turn a meeting transcript or a long document into a structured summary.
  • Keep a daily log or standup digest without leaving the terminal.

How to compare servers like this

Service scope:
Confirm the tool covers the exact service and surfaces (pages, tasks, calendars) you need.
Auth model:
See whether it uses an API token you control and what permissions that token grants.
Read vs write:
Start with read-only workflows; give write access only after the first results look right.
Maintenance signal:
For anything tied to a third-party API, prefer tools that track that API's changes.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the io.github.Ranork/remnus MCP server?

Remnus is an open-source, MCP-native workspace designed for human-agent collaboration. It provides pages, databases, kanban boards, and dashboards that Claude, Cursor, and other AI agents can read and write via MCP protocol. Built around Open Knowledge Format (OKF) for portable knowledge metadata and context-first workflows.

Remnus is a Notion alternative built from the ground up for AI agent integration via MCP. It lets you create and manage pages, databases with multiple views (table/kanban/calendar), and live dashboards—all accessible to AI agents through 27 MCP tools. Unlike Notion's MCP integration, Remnus is designed for headless, CI/CD, and coding agent workflows from day one, with OAuth 2.1 for editors and scoped tokens for headless agents.

How to install io.github.Ranork/remnus

Copy-paste configuration for popular MCP clients.

transport: http
Config generated by PluginBench — verify against the source before use.
~/.cursor/mcp.json
JSON config
{
  "mcpServers": {
    "remnus": {
      "url": "https://www.remnus.com/api/mcp"
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • prepare_context — Build Context Pack v2 with BM25 relevance ranking, OKF metadata, and graph relationships; returns short-lived contextRunId
  • search_workspace — Full-text search across pages and databases
  • list_workspace — List sidebar items with pagination
  • get_page — Get a page, database row, or dashboard by ID
  • get_pages — Batch retrieve multiple pages/rows by ID in one call
  • get_database_schema — Get column schema of a database
  • query_database — Query rows with filters and pagination
  • list_members — List workspace members with roles
  • query_audit_log — Filtered agent activity log
  • get_changes_since — Compact chronological feed of changes since timestamp or cursor
  • get_related_pages — Get a page's parent, children, outgoing links, backlinks, database siblings, and source files
  • create_page — Create a standalone page or database row with icon
  • bulk_create_pages — Create up to 50 pages or rows in one call with nesting support
  • update_page — Update title, content, or properties
  • bulk_update_pages — Update multiple rows in one call
  • delete_page — Delete a page, database, dashboard, or row (requires confirmation)
  • bulk_delete_pages — Delete up to 100 pages/rows/databases in one call (requires confirmation)
  • move_item — Move item to a new parent
  • bulk_move_items — Move up to 100 items in one call with reparenting support
  • create_database — Create a database with custom schema, icon, and views

Use cases

  • Build and maintain project dashboards that AI agents can update in real-time
  • Store and query structured data (databases with custom schemas) that agents can read and modify
  • Create knowledge bases with pages and nested hierarchies that agents can search and augment
  • Automate bulk operations: create, update, or delete dozens of pages/rows in a single agent call
  • Track agent activity and changes over time with audit logs and change feeds

io.github.Ranork/remnus MCP server FAQ

What is Remnus?

Remnus is an open-source, MCP-native workspace for human-agent collaboration. It provides pages, databases, kanban boards, and dashboards that AI agents like Claude and Cursor can read and write via MCP protocol, alongside human users.

Is Remnus free?

Yes. Remnus is open-source under AGPL-3.0 and free to self-host. You can deploy it locally, on Docker, Vercel, or Railway. SaaS forks must open-source their changes.

How do I connect Remnus to Cursor or Claude?

After signing in to your Remnus instance, open the AI Agents panel and click 'Connect editor.' It walks you through setup for Cursor, VS Code, Claude Code, and other editors. You can use OAuth 2.1 (token-less) or create a scoped personal access token for headless agents.

Do I need authentication to use Remnus MCP?

Yes. Remnus uses OAuth 2.1 + PKCE for editor connections (one-click sign-in) or scoped bearer tokens for headless/CI agents. Both are managed from the AI Agents panel in your workspace.

What makes Remnus different from Notion's MCP integration?

Remnus is built MCP-native from day one, designed for headless, CI/CD, and coding agent workflows. It uses Open Knowledge Format (OKF) for portable metadata, offers context-first flows with Smart/Strict MCP policies, and provides 27 tools for full read/write access to pages, databases, and dashboards.

Can I self-host Remnus?

Yes. Clone the repository, set up environment variables (AUTH_SECRET and OAuth credentials), and run locally with `npm run dev` or via Docker Compose. Deployment templates for Vercel and Railway are provided.

README (reference)

Source of truth, from the repository.

<p align="center"> <img src="public/remnus-animation.gif" alt="Remnus" width="100%" /> </p>

Remnus

Open-source MCP-native workspace for humans and AI agents.

Kanban boards, databases, and pages that Claude, Cursor, and any AI agent can read and write via MCP — alongside you.

GitHub Stars License: AGPL-3.0 Deploy with Vercel smithery badge MCP Registry


What is Remnus?

Remnus is the Human-Agent Collaborative Workspace, built around the Model Context Protocol (MCP). Every page, database, and kanban board in your workspace is accessible to AI agents via a first-class MCP server — connect editors with one-click OAuth 2.1 (PKCE), or use a scoped bearer token for headless / CI agents.

Unlike Notion's MCP integration, Remnus is designed for headless, CI/CD, and coding agent workflows from day one.

OKF-native context, not a workspace dump

Remnus uses Open Knowledge Format (OKF) ideas as a portable knowledge contract. Pages can carry descriptions, types, tags, sources, lifecycle state, freshness dates, and revision-bound review signals. OKF v0.2 import/export is the interchange layer; the editable Remnus workspace remains canonical.

The prepare_context MCP tool turns a concrete task into Context Pack v2: a token-budgeted set of concepts ranked by BM25 relevance, native metadata, page links, freshness, and trust. Smart mode advertises this context-first flow automatically for meaningful work. Strict mode additionally requires the same agent's short-lived contextRunId before Remnus MCP mutations.

This does not let an MCP server control local files, shell commands, or Git. Repository-level enforcement uses the supplied AGENTS.md and CLAUDE.md snippets. Read the public Context-First MCP guide and the implementation story, How Remnus Uses OKF to Give AI Agents Better Context.

Features

  • Pages — Markdown editor with slash commands, nested sub-pages, and icons
  • Databases — Customizable columns, Table / Kanban / Calendar views, filters, sorts
  • Dashboards — Live status screens (metrics, charts, lists, embedded views) that an agent builds from a few hundred tokens of JSON and a human can edit block by block
  • MCP Server — 27 tools + 7 resources + 7 prompts over stateless Streamable HTTP
  • OKF-native context — Portable knowledge metadata, exact-revision reviews, Context Pack v2, and Smart/Strict MCP policies
  • Agent auth — One-click OAuth 2.1 + PKCE (RFC 7591 dynamic registration) for editors, or scoped read/write personal access tokens for headless agents
  • Multi-workspace — Invite members, role-based access (owner / member / viewer)
  • Desktop app — Tauri v2 shell for Windows, macOS, Linux
  • Mobile — Capacitor v8 for iOS and Android (loads remnus.com)
  • i18n — English, Türkçe, हिन्दी, Español, Français, Deutsch, 中文, Русский

Quick Start — Self-host

Local Development

git clone https://github.com/Ranork/remnus-app.git
cd remnus-app
cp .env.example .env          # fill in AUTH_SECRET + OAuth credentials
npm install
npm run db:migrate
npm run dev

Open http://localhost:3000. The first user to sign up is auto-promoted to admin.

Docker Compose (5-minute setup)

If you prefer to run Remnus using Docker:

  1. Clone the repository and navigate into it:
    git clone https://github.com/Ranork/remnus-app.git
    cd remnus-app
    
  2. Copy the environment template and fill in the required variables (especially AUTH_SECRET and OAuth credentials):
    cp .env.example .env
    
  3. Start the application:
    docker compose up -d
    
  4. Access Remnus at http://localhost:3000. The SQLite database will be persisted automatically using a Docker volume.

Deploy

Deploy to Vercel Deploy to Railway

Add MCP to your editor

After signing in, open the AI Agents panel from the sidebar and click Connect editor. It walks you through every supported editor (Cursor, VS Code, Claude Code, Codex, Windsurf, and more).

Add to Cursor Add to VS Code

Install from a registry

Remnus is published on the official MCP Registry (io.github.Ranork/remnus) and on Smithery, so MCP-aware clients and directories can discover it automatically. Smithery offers one-click install across many clients (Claude, Cursor, VS Code, Codex, Windsurf, and more) — open the Smithery page and click Add to toolbox, or use the Smithery CLI to install straight into a client's config:

npx -y smithery@latest mcp add ranorkk/remnus --client claude

Swap --client for cursor, vscode, codex, windsurf, etc. Either way, the first connection runs the same OAuth 2.1 sign-in — no token to paste.

Recommended — OAuth (token-less): point your editor at the MCP URL and approve the consent screen on first connect. Your editor runs the OAuth 2.1 flow automatically — nothing to copy.

{
  "mcpServers": {
    "remnus": {
      "type": "http",
      "url": "https://your-instance.com/api/mcp"
    }
  }
}

Headless / CI — personal access token: create a scoped token from the AI Agents panel and send it as a bearer header.

{
  "mcpServers": {
    "remnus": {
      "type": "http",
      "url": "https://your-instance.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

MCP Tools

ToolScopeDescription
prepare_contextreadBuild Context Pack v2 (BM25 + OKF metadata + graph) and return a short-lived contextRunId
search_workspacereadFull-text search across pages and databases
list_workspacereadList sidebar items with pagination
get_pagereadGet a page, database row or dashboard (as its block spec) by ID
get_pagesreadGet multiple pages/rows by ID in one call (batch get_page)
get_database_schemareadGet column schema of a database
query_databasereadQuery rows with filters and pagination
list_membersreadList workspace members with roles
query_audit_logreadFiltered agent activity log
get_changes_sincereadCompact, chronological feed of what changed since a timestamp or cursor
get_related_pagesreadA page's parent, children, outgoing links, backlinks, database siblings and source files — or, given a file path, the pages that rest on it
create_pagewriteCreate a standalone page or database row, with an icon
bulk_create_pageswriteCreate up to 50 pages or rows in one call, nesting pages via ref/parentRef
update_pagewriteUpdate title, content, or properties
bulk_update_pageswriteUpdate multiple rows in one call
delete_pagewriteDelete a page, database, dashboard or row (requires confirm: true)
bulk_delete_pageswriteDelete up to 100 pages/rows/databases in one call (requires confirm: true)
move_itemwriteMove item to a new parent
bulk_move_itemswriteMove up to 100 items in one call, reparenting or moving rows to a different database
create_databasewriteCreate a database with custom schema, icon, and views
update_database_schemawriteAdd or remove columns
create_database_viewwriteAdd a table/kanban/calendar view
update_database_viewwriteRename a view or patch its config
delete_database_viewwriteDelete a saved view (requires confirm: true)
create_dashboardwriteCreate a live dashboard from JSON blocks; returns its URL and warnings for blocks that would render empty
update_dashboardwritePatch a dashboard by block id — add, update, remove, reorder
add_commentwriteAdd a comment to a page or row (agent comments are append-only)

Tech Stack

  • Framework: Next.js 16.2.6 (App Router)
  • Database: SQLite via Drizzle ORM + @libsql/client (Turso-compatible)
  • Auth: Auth.js v5 — Google & GitHub OAuth
  • Styling: Tailwind CSS + Lucide icons
  • Desktop: Tauri v2 (Rust)
  • Mobile: Capacitor v8

Contributing

See CONTRIBUTING.md. All contributions are welcome — bug fixes, new MCP tools, translations, and docs.

License

AGPL-3.0 — free to self-host and modify. SaaS forks must open-source their changes.

Related MCP servers

Rarefied Earth Groundwork MCP: company memory for AI agents. 14-day full-access trial, no card.

1
JavaScript
View repository →

Add papers and books to Zotero by DOI, arXiv ID, or ISBN and manage your library

0
Python
View repository →

Free source-backed NDIS pricing, packaging, care and licensing tools; searchable register previews.

Claude distils its past sessions into linked Markdown notes on disk and searches them later.

1
TypeScript
View repository →

Physics assistant: checked equations, live simulations, claims verified against arXiv papers

1
Python
MIT
View repository →

Bridge Claude with Perplexity Comet for autonomous web browsing and multi-tab research workflows.

48
TypeScript
MIT
View repository →