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.

What is Remnus?

Remnus is a Notion-like 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 — using a simple bearer token, with no OAuth dance required.

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

Features

Pages — Markdown editor with slash commands, nested sub-pages, and icons
Databases — Customizable columns, Table / Kanban / Calendar views, filters, sorts
MCP Server — 15 tools + 4 resources + 5 prompts, Streamable HTTP + SSE dual transport
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:

Clone the repository and navigate into it:

git clone https://github.com/Ranork/remnus-app.git
cd remnus-app

Copy the environment template and fill in the required variables (especially AUTH_SECRET and OAuth credentials):
```
cp .env.example .env
```
Start the application:
```
docker compose up -d
```
Access Remnus at http://localhost:3000. The SQLite database will be persisted automatically using a Docker volume.

Deploy

Add MCP to your editor

After signing in, go to Workspace Settings → Tokens and create a token, then:

Or add manually to your MCP client config:

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

MCP Tools

Tool	Scope	Description
`search`	read	Full-text search across pages and databases
`list_workspace`	read	List sidebar items with pagination
`get_page`	read	Get a page or database row by ID
`get_database_schema`	read	Get column schema of a database
`query_database`	read	Query rows with filters and pagination
`list_members`	read	List workspace members with roles
`query_audit_log`	read	Filtered agent activity log
`create_page`	write	Create a standalone page or database row
`update_page`	write	Update title, content, or properties
`bulk_update`	write	Update multiple rows in one call
`delete_page`	write	Delete a page (requires `confirm: true`)
`move_item`	write	Move item to a new parent
`create_database`	write	Create a database with custom schema
`update_database_schema`	write	Add or remove columns

Tech Stack

Framework: Next.js 15 (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.