Folio
Browse a folder of markdown and data live, with read-only MCP tools over it
- 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/folioAdd to claude_desktop_config.json
{
"mcpServers": {
"folio": {
"command": "npx",
"args": [
"-y",
"@jakubro/folio"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"folio": {
"command": "npx",
"args": [
"-y",
"@jakubro/folio"
]
}
}
}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

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

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents