Molio MCP

The MCP server lets agents read and search local Molio vaults, browse file trees and ask questions about their contents.

  • 443 ★ on the repository
  • Last commit
MCP serverOfficial

Extended access

Why this level

  • The agent receives selected vault contents; AI questions use the configured model even though MCP cannot modify documents.
All reasons and checks

zhuzhaoyun/molio

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/molio-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The agent receives selected vault contents; AI questions use the configured model even though MCP cannot modify documents.

This is third-party code. Review the repository files before installing.

What it does

Molio MCP connects external agents to an already running Molio knowledge service. Agents list vaults, browse file trees, read text and search. More complex questions can be passed to the AI runtime configured in Molio. The MCP layer is read-only: it cannot add, import or delete documents. The Molio platform prepares notes and converted files into knowledge collections that users can also explore directly.

Who it is for. Personal knowledge-base owners who want document retrieval inside Claude Code, Cursor or Codex conversations.

Good fit when

  • Agent work needs a note from an existing Molio vault.
  • An answer requires reading a file without permission to change it.
  • Several vaults need task-specific selection.
  • A complex knowledge question should use Molio’s configured AI runtime.

Not a fit when

  • You need document import or editing through this MCP layer.
  • No Molio service is running on the machine or server.
  • The agent must not receive the selected vault’s contents.

Example request

List Molio vaults, select the work vault and find API-structure decisions without modifying files.

MCP

Transport
stdio
Authentication
not required

Limitations

The CLI package requires Node.js 20 or later, separately from full-platform source-build requirements. Molio Desktop or its daemon must already be running because MCP only calls its API. Model-generated answers require an installed, configured AI runtime; ordinary search and reading do not provide one. Without an explicit vault selection, Molio uses the current vault, so check its name before queries when personal and work documents coexist.

How to disable. Remove Molio from the client’s MCP configuration. The external agent loses access, while Molio and its vaults remain; stop the service separately if needed.

FAQ

How do I check Molio availability?

Run `npx -y @molio/cli status` to inspect service health and the current vault.

How do I register it in Claude Code?

Use `claude mcp add molio -- npx -y @molio/cli mcp` with Molio running.

Why is a complex answer not immediate?

Molio starts a separate run and returns its identifier. The agent needs to wait for that run’s result.

How do I select another vault in the CLI?

Pass `--vault` with an ID or name; use the ID when names are ambiguous.

What if the service uses another port?

Set `MOLIO_PORT` or the complete address in `MOLIO_DAEMON_URL`, then check status again.

Discussion

No questions or reviews yet.

Official

The MCP server lets agents explore prepared documents, sections and related assets while retaining source references.

MCP serverExtended access3.9KRepository stars

A local document base for your agent: hybrid semantic and keyword search plus a web UI for browsing and uploads

MCP serverExtended access344Repository stars
Official

The MCP server connects an agent to a learning canvas where a question about a passage opens a linked document.

MCP serverExtended access327Repository stars

MCP PDF for large documents: the agent searches by meaning and keyword across one file or a folder and reads only the pages, tables and scans it needs

MCP serverExtended access166Repository stars
Official

An MCP server built on Docling: converts PDFs into structured documents, builds new ones and feeds them to RAG

MCP serverExtended access784Repository stars
Official

The MCP server answers questions from a personal document collection and returns linked passages with sources.

MCP serverExtended access612Repository stars

README in short

The CLI separates data from error messages and offers JSON output for scripts. Its Pi package also installs a knowledge-base skill.

README badge

Report a problem

Foxx AIMolio MCP
Foxx AI

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.