Skip to content
MCP server

Molio Knowledge Base

Read-only MCP access to a local Molio knowledge base: search, read, browse and ask

Runs locallyStatus and history
Install
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/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "molio": {
      "command": "npx",
      "args": [
        "-y",
        "@molio/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "molio": {
      "command": "npx",
      "args": [
        "-y",
        "@molio/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP 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
  4. Local-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
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity