Skip to content
MCP server

Folio

Self-hosted Git-backed team wiki that agents can search, read and edit over MCP

Install
Pricing
Open source
Platforms
self-hosted, Web, API
Runs
Remotely
Version
0.1.0
Listing updated
2 days ago

About Folio

Folio is an open-source MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://demo.foliowiki.online/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "folio": {
      "url": "https://demo.foliowiki.online/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Self-hosted; no paid plan stated

Prices change. Check foliowiki.online before you buy.

Folio 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 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. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. 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
  5. 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
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools