# Molio Knowledge Base

> Molio Knowledge Base is an open-source MCP server for knowledge and memory. Read-only MCP access to a local Molio knowledge base: search, read, browse and ask. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, self-hosted
- **Website:** https://molio.cn
- **Repository:** https://github.com/zhuzhaoyun/molio
- **MCP Registry name:** io.github.zhuzhaoyun/molio
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add molio -- npx -y @molio/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "molio": {
      "command": "npx",
      "args": [
        "-y",
        "@molio/cli"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "molio": {
      "command": "npx",
      "args": [
        "-y",
        "@molio/cli"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "molio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@molio/cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "molio": {
      "command": "npx",
      "args": [
        "-y",
        "@molio/cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "molio": {
      "command": "npx",
      "args": [
        "-y",
        "@molio/cli"
      ]
    }
  }
}
```

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/molio-knowledge-base
