Provides a live view and read-only tools for folders containing markdown and data files, including data validation and link checking.
Also known as jakubro/folio, @jakubro/folio
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 1,317
- Latest version
- 0.6.0
- Last commit
- Nov 14, 2026
- License
- GPL-3.0
What is Folio MCP?
Folio provides a live view and read-only tools for folders containing markdown and data files, including data validation and link checking.
Summary generated from the project's README
About Folio MCP server
Folio provides a live, read-only view of folders containing markdown and data files. It functions as a browser-based viewer that renders GitHub-flavored markdown, math, code highlighting, and diagrams. Users can run it locally using npx or by installing it globally via npm. It requires Node.js 22.18 or later to operate.
For developers using Claude Code, Folio can be integrated as an MCP server and agent skill plugin. This allows an AI client to access the same folder model used by the browser view. The server connects to a running Folio instance via a specific address, such as localhost:8641, or a socket.
This tool excels at maintaining folder health by tracking broken links, missing includes, and failing queries defined in a FOLIO.md file. It manages complex data relationships by linking prose figures to CSV, JSON, Parquet, or SQLite files, flagging discrepancies when data changes. It also tracks reading progress by marking new or changed blocks in documents.
What you can do with it
- 1Verify data consistencyAsk the AI to check if the numbers mentioned in your markdown prose still match the values in your underlying data files.
- 2Audit folder integrityInstruct the agent to identify broken links or failing rules within the documentation folder.
- 3Analyze data file structuresHave the client explore the contents of JSON or SQLite files through structured tables and trees.
- 4Track document changesUse the tool to see what specific blocks or lines have been added or removed since the last time a page was read.
Written from the project's README. Every use case is checked against a quote from it.
How to install Folio MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Folio MCP in Claude Code
$ claude mcp add folio -- npx -y @jakubro/folioInstall Folio MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"folio": {
"command": "npx",
"args": [
"-y",
"@jakubro/folio"
]
}
}
}Install Folio MCP in VS Code
.vscode/mcp.json
{
"servers": {
"folio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@jakubro/folio"
]
}
}
}Install Folio MCP in VS Code CLI
$ code --add-mcp '{"name":"folio","type":"stdio","command":"npx","args":["-y","@jakubro/folio"]}'Install Folio MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"folio": {
"command": "npx",
"args": [
"-y",
"@jakubro/folio"
]
}
}
}Install Folio MCP in Codex
$ codex mcp add folio -- npx -y @jakubro/folioInstall Folio MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.folio] command = "npx" args = ["-y", "@jakubro/folio"]
Install Folio MCP in Gemini CLI
$ gemini mcp add -s user folio npx -- -y @jakubro/folioInstall Folio MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"folio": {
"command": "npx",
"args": [
"-y",
"@jakubro/folio"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablejakubro/folio is public and reachablegithub.com/jakubro/folio ↗Pass
- Package names this repository as its source@jakubro/folio names jakubro/folio as sourcenpmjs.com/package/@jakubro/folio ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @jakubro/folionpmjs.com/package/@jakubro/folio/v/0.6.0#provenance ↗Pass
- Open source license (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-14github.com/jakubro/folio ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @jakubro/folioPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubFolio
A live view of a folder of markdown and data. Point Folio at a folder and read it in your browser: every page rendered with GitHub-flavoured markdown, math, highlighted code and diagrams, every page current the moment you save it, and the folder known as a whole - what you have not read yet, which figures no longer match their data, what links where and what is broken.
Install and run
npx @jakubro/folio ~/notes
Open the address it prints: http://localhost:8640/, or the next free port when that one is taken. Folio needs Node.js 22.18 or later; npm install --global @jakubro/folio keeps it installed as folio.
In Claude Code, two commands install Folio's MCP server and its agent skill as a plugin:
claude plugin marketplace add jakubro/folio
claude plugin install folio@folio
The plugin's tools read the Folio serving the folder Claude Code is opened in; its Folio setting, in /config, names another by its address, such as localhost:8641, or its socket.
What Folio does
Folio keeps a model of the whole folder:
- What is new to you. Folio remembers what you have read. Reopen a page and every block added, changed or removed since is marked - a table by its rows, a list by its items, code by its lines - the old wording a click away, and the tree points at every document that moved.
- Data files and data in documents. CSV, JSON, Parquet, SQLite and other data files open as tables and trees, with each column's spread under its header and, for any filter, what sets its records apart from the rest. A document embeds a table, a chart or a single value from them, or a SQL query across them, and each one redraws when its data changes.
- Tables that sort and filter. Tables written in a page, embedded from data or opened from a data file sort by several columns and filter by text, whole values, patterns or several values at once, the filters joined by and or or. None of it touches the file, and the view lives in the page's address.
- Figures checked against their data. Tie a number in your prose to the data it quotes, and Folio flags it the moment the data disagrees.
- Folder conventions and health. Declare kinds of documents and rules as queries in a
FOLIO.md. One health view - andfolio checkin CI - lists every broken link, missing include, failing query and broken rule. - History. Every version git holds, merged with the saves Folio saw, compared block by block, and digests of any day or week.
- Agents and editors. An MCP server, a JSON API and a language server give them the same model you read, and an agent skill teaches agents to write documents that use it.
The folder stays plain markdown: every page still reads on GitHub, and Folio writes into it only what a FOLIO.md asks for.
Documentation
Full documentation is published at jakubro.github.io/folio.
- Guide - every view Folio adds, with pictures
- Reference - every option, address, key and rule, and what Folio reads and writes
- Architecture - how Folio works inside, and why
License
Copyright (C) 2026 Jakub Roman. Distributed under the GNU GPL v3.
Folio MCP questions
How do I add Folio MCP to Claude Code?
Run claude mcp add folio -- npx -y @jakubro/folio in your terminal. Add --scope user to make it available in every project.
How do I add Folio MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What kind of data files does Folio support?
Folio can open CSV, JSON, Parquet, SQLite, and other data files as tables and trees.
Does Folio change my markdown files?
No, the folder stays as plain markdown and Folio only writes into it what is requested in a FOLIO.md file.
Can Folio check for broken links?
Yes, it can list every broken link, missing include, failing query, and broken rule.