# Folio

Lets an AI agent search, read and edit your team wiki — pages, data tables and whiteboards. Useful when docs live in Git next to the code.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 77
- Author: evergreen-it-dev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/evergreen-it-dev/folio
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/folio

## What it does

Folio stores every wiki page as a plain file in a Git repository. The MCP server exposes those same pages to an agent: it searches them, reads them and edits them, and each change lands as a commit. There is a built-in assistant, a per-space agent, and Markdown links written with agents in mind.

The connection runs over HTTP at `https://demo.foliowiki.online/mcp`. That endpoint is the demo instance: shared login, data resets every 24 hours, so keep personal data and API keys out of it. For a real wiki you run Folio yourself with `docker compose up -d` and open `http://localhost:4870`.

A space can be bound to a folder such as `docs/` in a product repository, which puts wiki edits and code changes in the same history. Front matter keys from Docusaurus, MkDocs, Hugo and Jekyll are kept byte for byte. Publishing a space as a read-only site is a separate setting.

## Requirements
- Needs: Docker
- Remote server: `https://demo.foliowiki.online/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http folio https://demo.foliowiki.online/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add folio --url https://demo.foliowiki.online/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "folio": {
            "url": "https://demo.foliowiki.online/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "folio": {
            "type": "http",
            "url": "https://demo.foliowiki.online/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http folio https://demo.foliowiki.online/mcp
```

## When to use it
- let an agent read and edit team wiki pages
- keep documentation in the same repository as the code
- find the right page on request instead of searching by hand
- update a roadmap table from an agent
- write release notes and add a roadmap row

## Example prompts
- Find the release process page in Folio and add notes about this version
- Add a row for the new feature to the roadmap table
- Show which pages in the space link to this document

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [Sui Knowledge Base (kapa.ai)](https://affpapa.org/en/nevibecode/mcp/sui-knowledge-base-kapaai.md) — MCP server · ★ 7784
- [Claude Code Ultimate Guide](https://affpapa.org/en/nevibecode/mcp/claude-code-ultimate-guide.md) — MCP server · ★ 6237
- [Zotero MCP](https://affpapa.org/en/nevibecode/mcp/zotero-mcp.md) — MCP server · ★ 5548
- [RevoGrid DataGrid MCP Pro](https://affpapa.org/en/nevibecode/mcp/revogrid-datagrid-mcp-pro.md) — MCP server · ★ 3450
- [Claude Code Explorer MCP](https://affpapa.org/en/nevibecode/mcp/codeaashu-claude-code-explorer-mcp.md) — MCP server · ★ 3409

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md