Remnus
About
MCP-native open-source Notion alternative. Read and write pages, customizable databases, and kanban/calendar boards through a remote MCP server with OAuth 2.1 and a full audit log.
Details
- Author
- Ranork
- Downloads
- 562
- Categories
- Productivity, Other, Database, Project Management, Automation, Developer Tools, Knowledge Base
Jump to
- Remote hosted MCP server using streamable HTTP
- OAuth 2.1 + PKCE with scoped read/write tokens
- Every agent write is recorded in an audit log
- Pages, databases, kanban, and calendar views
- 14 tools covering read and write operations
- Listed on MCP Registry, Glama, and Glama
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
RemnusCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Add the remote endpoint to your MCP client configuration using the URL https://www.remnus.com/api/mcp. Authentication is handled via OAuth 2.1 + PKCE – no token to paste. Once connected, agents can use 14 tools to read and write workspace content.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"remnus": {
"remnus": {
"url": "https://www.remnus.com/api/mcp"
}
}
}
}McpServers
{
"remnus": {
"url": "https://www.remnus.com/api/mcp"
}
}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.
Remnus is the Human-Agent Collaborative Workspace, built around theModel 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-clickOAuth 2.1 (PKCE), or use a scopedbearer tokenfor 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.
Theprepare_contextMCP 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.Smartmode advertises this context-first flow automatically for meaningful work.Strictmode additionally requires the same agent's short-livedcontextRunIdbefore Remnus MCP mutations.
This does not let an MCP server control local files, shell commands, or Git. Repository-level enforcement uses the suppliedAGENTS.mdandCLAUDE.mdsnippets. Read the publicContext-First MCP guideand the implementation story,How Remnus Uses OKF to Give AI Agents Better Context.
- Pages— Markdown editor with slash commands, nested sub-pages, and icons
- Databases— Customizable columns, Table / Kanban / Calendar views, filters, sorts
- MCP Server— 21 tools + 6 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, 中文, Русский
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
Openhttp://localhost:3000. The first user to sign up is auto-promoted to admin.
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
After signing in, open theAI Agentspanel from the sidebar and clickConnect editor. It walks you through every supported editor (Cursor, VS Code, Claude Code, Codex, Windsurf, and more).
Remnus is published on theofficial MCP Registry(io.github.Ranork/remnus) and onSmithery, 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 theSmithery pageand clickAdd 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--clientforcursor,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>" } } } }
- 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
SeeCONTRIBUTING.md. All contributions are welcome — bug fixes, new MCP tools, translations, and docs.
AGPL-3.0— free to self-host and modify. SaaS forks must open-source their changes.
Perform queries and entity operations in your Fibery workspace.
A universal remote MCP server that connects to popular productivity tools such as Notion, Monday, AirTable, and many more.
Official Notion MCP server for searching, reading, creating, and updating Notion pages, databases, and workspace content from AI agents.
Keep teams & agents coordinated automatically
Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.
advanced-math-mcp — MCP server for linear algebra, calculus, and symbolic math. 17 tools with a unified evaluate() expression engine. Supports matrices, eigenvalues, SVD, integrals, limits, derivatives, and more.
An MCP interface for Atlassian products, including Jira and Bitbucket.
The Outcome Backcasting MCP is a strategic planning tool that helps you work backwards from a desired future outcome to identify the specific steps, resources, and dependencies needed to achieve your goals. Unlike traditional forward planning, backcasting starts with your end goal and creates a reverse roadmap to get there.
Markdown-first Notion MCP server with 9 composite tools, 39 actions, and ~77% token reduction via tiered docs.
About A repo-native task graph as plain Markdown files, served to AI agents over MCP and to humans over a clean web UI .
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
