Remnus

io.github.RanorkPublished by GitHub account Ranorkv1.0.0Updated Oct 24, 2026

MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.

VerifiedStreamable HTTPWeb executableDatabasesProductivity & WorkflowKnowledge & Memory

Overview

AI-generated overview

Remnus is a hosted, MCP-native workspace (open-source Notion alternative) whose server lets an assistant read and write pages, databases, dashboards and…

What you can do
  • Search and browse the workspace: full-text search, sidebar listing, member and audit-log queries, and a change feed since a timestamp.
  • Read content: fetch pages, rows and dashboards by ID, batch fetches, database schemas, filtered row queries, and related pages or backlinks.
  • Build task context: prepare_context assembles a token-budgeted Context Pack ranked by relevance, metadata, links and freshness.
  • Create and edit content: create, update, move and delete pages and rows, including bulk operations up to 50-100 items.
  • Manage structure: create databases and views, add or remove columns, and create or patch dashboards from JSON blocks.
  • Collaborate: add comments to pages or rows.
When to use it
Useful when a team keeps its notes, databases and boards in Remnus and wants coding or chat agents to read and update that workspace directly, including headless or CI agents that need scoped token access rather than a browser session.
Requirements
A remote MCP endpoint on a Remnus instance (the hosted service or a self-hosted deployment). Authentication is required: OAuth 2.1 with PKCE for editors, or a scoped personal access token sent as a bearer Authorization header for headless agents. Self-hosting needs Node.js, a filled .env with AUTH_SECRET and OAuth credentials, and a database migration.
Before you install
The server can write: it creates, updates, moves and deletes pages, rows, databases and views, with bulk deletes up to 100 items, so destructive calls should be reviewed even though they require confirm: true. Personal access tokens grant scoped read or write access to the whole workspace and should be kept secret and rotated. Agent comments are append-only. Content read and written passes through the Remnus instance you connect to.

Installation

In SourceWeft

  1. Open Remnus in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Ranork%2Fremnus/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

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

README

[Remnus]

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 — 28 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

bash
git clone https://github.com/Ranork/remnus-app.gitcd remnus-appcp .env.example .env          # fill in AUTH_SECRET + OAuth credentialsnpm installnpm run db:migratenpm 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:
    bash
    git clone https://github.com/Ranork/remnus-app.gitcd remnus-app
  2. Copy the environment template and fill in the required variables (especially AUTH_SECRET and OAuth credentials):
    bash
    cp .env.example .env
  3. Start the application:
    bash
    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:

bash
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.

json
{  "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.

json
{  "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
get_statusreadCheck this connection: workspace, scope, when the token expires and what to do about 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.

Source: README.md at commit bc3c57a

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts