Skip to content
MCP server

Folio

Browse a folder of markdown and data live, with read-only MCP tools over it

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
0.6.0
Listing updated
3 days ago

About Folio

Folio is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Folio first of all serves a folder in your browser: GitHub-flavoured markdown with math, highlighted code and diagrams, refreshed as you save. What distinguishes it is that it models the whole folder, remembering what you have already read and marking every block added, changed or removed since, flagging figures in prose that no longer match the data they quote, and reporting broken links and failing rules in one health view.

Data files such as CSV, JSON, Parquet and SQLite open as tables and trees, and documents can embed a table, chart, single value or SQL query that redraws when data changes. An MCP server, a JSON API and a language server expose the same model to agents and editors, and the registry describes the MCP tools as read-only. In Claude Code, a plugin installs the server plus an agent skill.

It needs Node.js 22.18 or later, runs locally on port 8640 by default, and keeps its own state under ~/.local/state/folio. Folio writes into the folder only what a FOLIO.md asks for. The licence is GPL v3.

Install

Run in a terminal

claude mcp add folio -- npx -y @jakubro/folio

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "folio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jakubro/folio"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "folio": {
      "command": "npx",
      "args": [
        "-y",
        "@jakubro/folio"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "folio": {
      "command": "npx",
      "args": [
        "-y",
        "@jakubro/folio"
      ]
    }
  }
}

What it does

Live rendering
Shows markdown with math, code and diagrams, updated as files are saved.
Read tracking
Marks blocks added, changed or removed since you last read a page.
Data in documents
Embeds tables, charts, values and SQL queries from CSV, JSON, Parquet or SQLite.
Figure checks
Flags numbers in prose that no longer match the data they quote.
Folder health view
Lists broken links, missing includes and failing rules, also via folio check in CI.
History
Compares git versions and saved versions block by block, with day or week digests.

Good for

  • Give an agent read-only access to a notes or docs folder
  • Catch out-of-date numbers in written reports
  • Catch up on what changed in a shared docs folder
  • Check a docs folder for broken links in CI
  • Explore CSV or SQLite data next to the writing about it

Pricing

Open source

Free, GPL v3

Prices change. Check jakubro.github.io before you buy.

Folio FAQ

What does Folio need to run?

Node.js 22.18 or later; start it with npx @jakubro/folio and a folder path.

Does it modify my files?

It writes into the folder only what a FOLIO.md there asks for; its own state is kept in ~/.local/state/folio.

How do I use it from Claude Code?

Add the marketplace with claude plugin marketplace add jakubro/folio, then install folio@folio.

What licence is it?

GNU GPL v3.

Is Folio free?

Yes. Folio is open source, so you can use and self-host it for free.

How do I add Folio to Claude Code?

Run this command in your terminal: claude mcp add folio -- npx -y @jakubro/folio

What are the best alternatives to Folio?

The closest alternatives to Folio are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to Folio

  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
  6. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents