Skip to content

Connect your AI tools to Folio

To connect an AI client to Folio over MCP, add your Folio's /mcp address as a remote MCP server. Claude and ChatGPT sign in with OAuth. Claude Code, Cursor, VS Code, Codex, n8n and Open WebUI send a personal access token as a Bearer header. Either way, the client acts with your rights, narrowed by the token scope.

Shared knowledge for humans and agents, backed by Git. People write pages in the browser. Agents read and write the same pages over MCP: 49 tools for search, pages, tables, forms, whiteboards, bases, writing-rule checks and the link graph. Any client that speaks remote MCP can connect. These pages cover the ones people ask about most.

Updated

Read more: Confluence MCP, Notion MCP and a wiki that is its own MCP server.

OAuth or a token

Folio supports both. The client decides which one you use.

OAuthPersonal access token
Used byClaude, ChatGPT, and clients that can open a sign-in pageClaude Code, Cursor, VS Code, Codex, n8n, Open WebUI
How it worksThe client opens Folio's sign-in and consent screen. You choose read, or read and write.You create a token under API tokens and put it in the client's config as a Bearer header.
Whose rightsThe person who signed inThe person who owns the token
RevokeUser menu, API tokens, Connected appsUser menu, API tokens, delete the token
LifetimeOne-hour access token, 30-day rotating refresh tokenUntil you delete it
Good forPeople who want to use their own account in a chatScripts, servers and agents with their own Folio user

The full OAuth reference is in the MCP docs.

What an agent can do

Twenty-three tools. Thirteen read, ten write. A connection never has more rights than the person behind it, and the write tools refuse to run on a read-only connection.

Ready-made config files, a Claude Code plugin, two n8n workflows and an onboarding setup are in the integrations folder of the Folio repository.

Reading (23)
Reading (23)What it does
list_spacesSpaces you can see, with your role in each
list_treeThe page tree of a space
list_templatesThe page templates of a space
search_pagesFull-text search across the pages you can open, with filters
read_pageA page as Markdown, with its metadata; a form's fields, a canvas's outline, a base's YAML
resolve_folio_urlA Folio link to the page it points at
get_backlinksPages that link to a page
page_historyThe Git commits that touched a page
page_at_shaA page as it was at a given commit
get_page_metadataA page's headings, block ids, tags, properties and links
list_unresolved_linksLinks in a space that point at nothing
list_orphansPages in a space that nothing links to
get_graphThe link graph of a space, or the neighbourhood of one page
list_tagsThe tag tree of a space with page counts
list_propertiesThe property keys in use, with their types and sample values
query_baseThe rows of an Obsidian base view
folio_table_listData tables in a space
folio_table_schemaA table's real columns, types and options
folio_table_queryTable rows with filter, sort and search
searchThe same search under the name ChatGPT deep research looks for
fetchA page by the id that search returned, as Markdown
check_page_writing_rulesThe space's writing rules and a page's text, so the agent can check the page against them; nothing is changed
list_commentsThe inline comment threads of a page, with the text each is attached to and its status
Writing (26)
Writing (26)What it does
create_pageA new document with text, or a table with columns
update_pageReplace the text of a page; merges with live editing
create_page_from_templateA new page copied from a template, with date, author and title filled in
save_page_as_templateCopy an existing page into the templates of its space
create_templateA new page template in the space's templates folder
publish_artifactAn interactive HTML page, such as a Claude artifact, published as a page
create_boardA whiteboard from a short description of boxes and arrows
update_boardReplace a whiteboard's scene
board_opsAlign, distribute, move or auto-layout board elements
convert_canvas_to_boardAn editable whiteboard made from an Obsidian canvas
create_formA form with its fields, and the table its answers go to
update_formChange a form's fields; the paired table follows
folio_table_createA table with an explicit schema
folio_table_add_columnA new column
folio_table_update_columnRename a column or change its type or options
folio_table_delete_columnA column and its values
folio_table_save_viewA saved view with its filter, sort and hidden columns
folio_table_delete_viewA saved view
folio_table_insertNew rows
folio_table_updateCells, by row id or by filter
folio_table_deleteRows, by id
rename_tagRename a tag across a space, in one commit
set_page_propertiesA page's properties, for any kind of page
save_baseCreate an Obsidian base or replace its YAML
add_commentA new inline comment thread on a passage of a page
reply_commentA reply in an existing comment thread

Try it on the demo first

Point an OAuth client at https://demo.foliowiki.online/mcp, sign in as Sam on Folio's login screen and ask about the fictional Acme handbook. The demo login is shared and its data resets every 24 hours, so a connection to it is erased with the reset. Do not connect an agent that has a shell or your own keys, and do not enter personal data. The demo does not issue personal tokens, so token clients need your own Folio.

Demo MCP address
https://demo.foliowiki.online/mcp

Any other client

Folio works with any MCP client that supports remote servers over HTTP. If the client can send a custom header, use a token. If it can open a sign-in page, use OAuth. Most clients accept a config like this one.

mcp.json
{
  "mcpServers": {
    "folio": {
      "url": "https://your-folio.example.com/mcp",
      "headers": { "Authorization": "Bearer folio_pat_..." }
    }
  }
}

Free browser tools for the same documents: Confluence to Markdown and Mermaid live editor. For the pages an agent will read and write, start from a Markdown template: the onboarding checklist even includes starter rules for the Folio assistant.

Frequently asked questions

What do I need to connect an AI client to Folio?

Your own Folio address ending in /mcp, and either a Folio account (for OAuth) or a personal access token from the user menu, API tokens (for clients that take a header). Folio has no self-registration, so an administrator invites you. The comparison table on this page shows which client uses which.

Which AI clients work with Folio over MCP?

Claude (claude.ai and Claude Desktop), ChatGPT, Claude Code, Cursor, VS Code with GitHub Copilot, Codex, n8n and Open WebUI have their own pages here. Any other client that supports remote MCP over HTTP can use the generic config further down.

How do I add Folio to Cursor, Codex or Claude Code in one step?

Claude Code: claude mcp add --transport http folio https://your-folio.example.com/mcp --header "Authorization: Bearer folio_pat_...". Codex: a [mcp_servers.folio] entry in config.toml with bearer_token_env_var. Cursor: a .cursor/mcp.json with the address and a Bearer header. Each page has the exact file.

Can I connect ChatGPT to Folio?

Yes, as a custom MCP server with OAuth, if your Folio is reachable over HTTPS from the public internet. Folio exposes search and fetch, so ChatGPT deep research can use it too. See the ChatGPT page.

Can I connect Claude to Folio?

Yes. In claude.ai or Claude Desktop, add Folio as a custom connector by its /mcp address and sign in with OAuth. Claude Code connects with a token or OAuth. See the Claude and Claude Code pages.

Does my Folio have to be on the public internet?

For claude.ai, Claude Desktop and ChatGPT, yes: their servers make the request, not your computer. For Claude Code, Cursor, VS Code, Codex and a self-hosted n8n or Open WebUI, the client runs on your side, so a Folio on your network is enough.

Can an agent see pages I cannot?

No. A connection acts with the rights of the person behind it, narrowed by the scope. A restricted page stays invisible to it.

How do I cut an agent off?

Delete its token under API tokens, or remove the app under Connected apps. It stops working immediately. Everything it wrote is in Git history and can be reverted.

Is there a hosted Folio I can point Claude at?

Only the public demo at https://demo.foliowiki.online. It is shared, resets every 24 hours and is meant for trying, not for work. For real use, run your own.

Something does not connect? See how to get support: bug reports and questions go to GitHub, and the support page lists what to include.