Molio Knowledge Base
Read-only MCP access to a local Molio knowledge base: search, read, browse and ask
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.2
- Listing updated
- 2 days ago
About Molio Knowledge Base
Molio Knowledge Base is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Molio is a desktop app that turns notes, books, scanned PDFs, Office files and web clippings into a plain-Markdown knowledge base on your own machine. Its wiki engine extracts entities and concepts and links them, and agents such as Claude Code and Codex then work against that base and write their results back as Markdown.
This MCP server is the read-only door into that base. It is the @molio/cli npm package, runs over stdio and talks to the Molio daemon's local HTTP API. The registry entry lists a MOLIO_PORT variable for the daemon port, with 3100 as the default, so the Molio app has to be running.
The README says everything stays local and nothing goes through a third-party server. PDF and Office conversion uses a bundled docling tool, and its first run downloads about 500 MB of models. The project is MIT licensed, and the site shows pre-built knowledge bases, for example one built from a classical Chinese history text, that can be imported.
Install
Run in a terminal
claude mcp add molio -- npx -y @molio/cliAdd to claude_desktop_config.json
{
"mcpServers": {
"molio": {
"command": "npx",
"args": [
"-y",
"@molio/cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"molio": {
"command": "npx",
"args": [
"-y",
"@molio/cli"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"molio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@molio/cli"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"molio": {
"command": "npx",
"args": [
"-y",
"@molio/cli"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"molio": {
"command": "npx",
"args": [
"-y",
"@molio/cli"
]
}
}
}Configuration
MOLIO_PORTPort of the Molio daemon HTTP API (default: 3100)
What it does
- Search and read
- Looks up and opens documents in the local knowledge base.
- Browse the base
- Navigates the folder and wiki structure that Molio builds.
- AI question answering
- Answers questions using the contents of the base.
- Local-first design
- Talks to a daemon on localhost, so documents stay on the user's computer.
- Broad import formats
- The app converts PDF, Word, PowerPoint, Excel, images and web clips into Markdown.
- Obsidian compatibility
- A vault can be opened in place, with original files kept read-only.
Good for
- Let Claude Code research across years of personal notes
- Query a digested book or PDF collection from an AI client
- Answer questions from an Obsidian vault without uploading it
- Import a ready-made domain knowledge base and ask about it
Pricing
Open source
Free, MIT licence
Prices change. Check molio.cn before you buy.
Molio Knowledge Base FAQ
Can the server change my notes?
The registry describes it as read-only access with search, read, browse and Q&A.
How do I install it?
It is the @molio/cli package on npm and runs over stdio. The Molio daemon must be running, on port 3100 unless MOLIO_PORT is set.
Does my data leave my computer?
The README says everything runs locally and never passes through a third-party server.
What licence is Molio under?
The site and README say MIT, free and open source.
Is Molio Knowledge Base free?
Yes. Molio Knowledge Base is open source, so you can use and self-host it for free.
How do I add Molio Knowledge Base to Claude Code?
Run this command in your terminal: claude mcp add molio -- npx -y @molio/cli
What are the best alternatives to Molio Knowledge Base?
The closest alternatives to Molio Knowledge Base are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.
Alternatives to Molio Knowledge Base

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
MedXpert 图书馆连接器(通用版)
MCP serverLocal MCP server that searches and answers questions over your own Markdown wiki
Runs locally- 4 tools
- Open source
- Knowledge and memory