Minakeep

Minakeep is a self-hosted knowledge vault for people who want one trusted place to capture private markdown notes, save reference links, enrich them with AI metadata, and selectively publish the pieces that should become public.

It is also built to become a source-of-truth repository for agents. Through Minakeep's optional MCP resources endpoint, your published notes and curated links can be exposed as read-only MCP resources, so compatible AI clients can discover and read your canonical public knowledge without scraping pages or touching the private vault.

Demo

• Demo site: https://minakeep.mina.asia/
• Demo username: demo
• Demo password: demo
• Demo mode is read-only, so the real workspace can be inspected without allowing mutations.

Why It Exists

Most personal knowledge tools split the world in two: private capture or public publishing. Minakeep keeps both in one small, self-hosted system.

• Capture notes and links privately first.
• Let AI generate summaries and tags without replacing your writing.
• Publish selected notes and links into one public showroom.
• Turn public knowledge into MCP-readable resources for agent workflows.
• Keep ownership simple with SQLite, filesystem media, and Docker-friendly deployment.

MCP As Source Of Truth

Minakeep's MCP endpoint is intentionally narrow and safe:

• disabled by default
• read-only resources only
• published notes and safe published links only
• no private vault access
• no mutation tools
• optional public access or bearer-token access
• compatible with the upstream MCP Inspector

This makes Minakeep useful as a canonical public knowledge repository: write and curate in the owner workspace, publish only what is ready, then let MCP-aware clients read the same trusted source.

Resource templates:

minakeep://articles/note/{slug}
minakeep://articles/link/{id}

Product Shape

• Private markdown note workspace
• Private saved-link capture
• Automatic AI summaries and tags
• Selective publishing for notes and links
• Mixed public homepage for published writing and curated references
• Title-only public search
• Owner-only private search by title, URL, and tag
• Uploaded note images and cached link favicons
• Read-only demo workspace
• Docker/Compose deployment with mounted data, media, and logs

Quick Start

npm install
npm run db:prepare
npm run dev

Open http://127.0.0.1:3000.

Default local owner credentials come from .env:

OWNER_USERNAME="owner"
OWNER_PASSWORD="minakeep-local-password"

Guides

• Guides index
• Local development
• MCP resources and Inspector
• Docker and Compose deployment
• External note API
• Verification and useful commands
• Ralph development workflow

Deeper Docs

• Architecture
• Product sense
• Product specs index
• Frontend behavior
• Execution planning
• Security notes
• Reliability notes

Tech Stack

• Next.js App Router
• TypeScript
• Prisma + SQLite
• Auth.js
• Playwright
• Docker / Docker Compose
• @minasoft/mcp-runtime

Project Layout

• src/ application code
• docs/ product specs, design docs, guides, and execution plans
• scripts/ runtime helpers, smoke checks, and Ralph loop scripts
• state/ Ralph state and task history
• tests/ unit and end-to-end coverage

Minakeep keeps the docs tree as the system of record. Product behavior belongs in specs, implementation work belongs in executable plans, and public knowledge belongs in published notes and links.