# Folio

> Folio is an open-source MCP server for knowledge and memory. Self-hosted Git-backed team wiki that agents can search, read and edit over MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, Web, API
- **Website:** https://foliowiki.online/integrations/
- **Repository:** https://github.com/evergreen-it-dev/folio
- **MCP Registry name:** io.github.evergreen-it-dev/folio
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-15

## About

Folio stores each page as a plain file in a Git repository you control, so stopping use leaves readable files. People edit in the browser in real time while agents use the same pages through 49 MCP tools: 23 reading and 26 writing across spaces, pages, tables, forms, whiteboards, bases, writing-rule checks and the link graph.

Reading tools include search_pages, read_page, get_backlinks, page_history, page_at_sha and query_base, while writing tools include create_page and update_page. A connection never has more rights than the person behind it, and write tools refuse on a read-only connection. Claude and ChatGPT sign in with OAuth (one-hour access tokens, 30-day rotating refresh tokens); Claude Code, Cursor, VS Code, Codex, n8n and Open WebUI use a personal access token.

Run it with docker compose. The README mentions SSO via OpenID Connect and SAML, SCIM, an audit log and publishing a space as a public site. A demo with data reset every 24 hours is available.

## Features

- **Git-backed pages:** Every page is a plain file in a repository you own.
- **49 MCP tools:** 23 reading and 26 writing tools across pages, tables, forms and whiteboards.
- **OAuth or token:** OAuth for chat apps, personal access tokens for coding agents and automation.
- **Scoped rights:** Connections are limited to the signed-in person's rights and token scope.
- **Link graph and history:** Backlinks, orphans, page history and graph views.
- **Self-hosting:** One docker compose command to run.

## Good for

- Let a coding agent read team conventions while it works
- Have an agent update release notes in the wiki
- Search a team wiki from Claude or ChatGPT
- Audit orphan pages and broken links
- Publish a space as a read-only site

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http folio https://demo.foliowiki.online/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://demo.foliowiki.online/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "folio": {
      "url": "https://demo.foliowiki.online/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "folio": {
      "type": "http",
      "url": "https://demo.foliowiki.online/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "folio": {
      "serverUrl": "https://demo.foliowiki.online/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "folio": {
      "type": "http",
      "url": "https://demo.foliowiki.online/mcp"
    }
  }
}
```

## Tools

- `list_spaces`: Spaces you can see, with your role.
- `search_pages`: Full-text search across readable pages.
- `read_page`: A page as Markdown with metadata.
- `get_backlinks`: Pages that link to a page.
- `page_history`: Git commits that touched a page.
- `query_base`: Rows of an Obsidian base view.
- `create_page`: Creates a new document or table.
- `update_page`: Replaces a page's text, merging with live editing.

## FAQ

### How do clients authenticate?

Claude and ChatGPT use OAuth; others send a personal access token as a Bearer header.

### Can an agent write to the wiki?

Yes, if the connection has write rights; read-only connections refuse write tools.

### How do I run it?

Clone the repo and run docker compose up -d, then open localhost:4870.

### Is there a demo?

Yes, demo.foliowiki.online, with data reset every 24 hours.

### 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 --transport http folio https://demo.foliowiki.online/mcp

### What are the best alternatives to Folio?

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

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/folio
