Connect ChatGPT to Folio
To connect ChatGPT to Folio, open Plugins, choose the custom MCP server option, enter your Folio's /mcp address and set authentication to OAuth. ChatGPT sends you to Folio's sign-in and consent screen, where you choose read, or read and write. ChatGPT then acts with your rights. Folio must be reachable over HTTPS from the public internet.
Updated
Answers with links, writes after approval
Ask:
Find our onboarding checklist and tell me what is left for week one. Give me the link. Then add a row to the Roadmap table: Public changelog page, status Planned.
ChatGPT reads the page and answers with its link. For the row it asks you to confirm the write, then the row appears in the table and in Git history.
Connect
What you need
- A Folio instance reachable over HTTPS from the public internet. For private networks OpenAI offers a Secure MCP Tunnel.
- PUBLIC_URL set to that address on the Folio side.
- A ChatGPT workspace that allows custom MCP servers. OpenAI says workspace permissions apply. We could not confirm from its documents which personal plans include the feature, so check the Plugins page in your own account.
- A Folio account, from an administrator's invitation.
Steps
Step 1: Check that your Folio answers like an OAuth-protected server: a 401 with a WWW-Authenticate header.
bashcurl -si -X POST https://your-folio.example.com/mcp \ -H 'content-type: application/json' -d '{}' | head -8Step 2: In ChatGPT open Plugins, click the plus and choose the custom MCP server option. The label reads Create custom MCP server or Add custom MCP server, depending on the version. Enter a name, an optional description and the server URL.
Server URLhttps://your-folio.example.com/mcpStep 3: Set authentication to OAuth. Folio supports client ID metadata documents, the method ChatGPT uses, so you do not need a client ID or a secret.
Step 4: Accept the risk warning, then create the server as a plugin and install it. ChatGPT sends you to Folio's sign-in and consent screen. Choose read to start, or read and write if you want it to edit.
Step 5: In a chat, mention the plugin with @ and ask your question.
Try it against the demo
Add https://demo.foliowiki.online/mcp the same way, sign in as Sam, and ask: "Find the Release process page and tell me which checklist items are still open."
https://demo.foliowiki.online/mcpThe demo login is shared and the data resets every 24 hours, which also removes your connection. Pages written by other visitors are untrusted data, so do not connect an agent that has a shell or your own keys, and do not enter personal data. Requests are rate limited.
What the agent can do
Folio exposes 49 tools over MCP. Full reference.
| Reading (23) | What it does |
|---|---|
list_spaces | Spaces you can see, with your role in each |
list_tree | The page tree of a space |
list_templates | The page templates of a space |
search_pages | Full-text search across the pages you can open, with filters |
read_page | A page as Markdown, with its metadata; a form's fields, a canvas's outline, a base's YAML |
resolve_folio_url | A Folio link to the page it points at |
get_backlinks | Pages that link to a page |
page_history | The Git commits that touched a page |
page_at_sha | A page as it was at a given commit |
get_page_metadata | A page's headings, block ids, tags, properties and links |
list_unresolved_links | Links in a space that point at nothing |
list_orphans | Pages in a space that nothing links to |
get_graph | The link graph of a space, or the neighbourhood of one page |
list_tags | The tag tree of a space with page counts |
list_properties | The property keys in use, with their types and sample values |
query_base | The rows of an Obsidian base view |
folio_table_list | Data tables in a space |
folio_table_schema | A table's real columns, types and options |
folio_table_query | Table rows with filter, sort and search |
search | The same search under the name ChatGPT deep research looks for |
fetch | A page by the id that search returned, as Markdown |
check_page_writing_rules | The space's writing rules and a page's text, so the agent can check the page against them; nothing is changed |
list_comments | The inline comment threads of a page, with the text each is attached to and its status |
| Writing (26) | What it does |
|---|---|
create_page | A new document with text, or a table with columns |
update_page | Replace the text of a page; merges with live editing |
create_page_from_template | A new page copied from a template, with date, author and title filled in |
save_page_as_template | Copy an existing page into the templates of its space |
create_template | A new page template in the space's templates folder |
publish_artifact | An interactive HTML page, such as a Claude artifact, published as a page |
create_board | A whiteboard from a short description of boxes and arrows |
update_board | Replace a whiteboard's scene |
board_ops | Align, distribute, move or auto-layout board elements |
convert_canvas_to_board | An editable whiteboard made from an Obsidian canvas |
create_form | A form with its fields, and the table its answers go to |
update_form | Change a form's fields; the paired table follows |
folio_table_create | A table with an explicit schema |
folio_table_add_column | A new column |
folio_table_update_column | Rename a column or change its type or options |
folio_table_delete_column | A column and its values |
folio_table_save_view | A saved view with its filter, sort and hidden columns |
folio_table_delete_view | A saved view |
folio_table_insert | New rows |
folio_table_update | Cells, by row id or by filter |
folio_table_delete | Rows, by id |
rename_tag | Rename a tag across a space, in one commit |
set_page_properties | A page's properties, for any kind of page |
save_base | Create an Obsidian base or replace its YAML |
add_comment | A new inline comment thread on a passage of a page |
reply_comment | A reply in an existing comment thread |
- Reading needs the read scope. Writing needs write. With read only, every tool that changes something refuses to run.
- All 49 tools carry read-only or destructive annotations, so a client can ask before it writes.
- An agent cannot manage access rights, invite people, or rename and delete spaces. Those actions exist only in the browser.
- A write reaches the page file at once. The Git commit follows after about 90 seconds of quiet, so page history can lag behind an edit.
- ChatGPT asks for confirmation before write actions by default. Folio marks its reading tools as read-only, so reads should go through without a prompt. Folio exposes search and fetch, so ChatGPT deep research can use it.
Security
- You sign in to your own Folio account and choose read, or read and write, on the consent screen. The connection acts with your rights and nothing more: a page you cannot open stays invisible to it.
- Writes are saved to Git history under your name.
- Access tokens last one hour and are renewed by a refresh token that rotates on every use. Folio stores only hashes of them.
- To disconnect, open the user menu, then API tokens, then Connected apps, and remove the app. Its tokens stop working immediately. Disabling the user does the same.
- An OAuth token works on /mcp only, not on the REST API.
- Page content is data, not instructions. Folio's tool descriptions say so, but the real protection is rights. An agent that also has a shell and write access can be misled by a page someone else wrote, so give it the narrowest token that does the job.
- ChatGPT can send what it reads from Folio to OpenAI. Connect only the spaces you are happy to share with it, and use a read-only consent when you only need answers.
Limits and honest notes
- ChatGPT cannot send a static token or a custom header, so there is no token route here. It is OAuth or nothing. Codex, OpenAI's coding agent, does take a token: see the Codex page.
Read more
Frequently asked questions
How do I add Folio to ChatGPT as a custom MCP server?
Open Plugins, click the plus, choose the custom MCP server option, enter a name and your /mcp address, and set authentication to OAuth. Folio supports client ID metadata documents, so no client ID or secret is needed. Install it, sign in to Folio, and mention the plugin with @ in a chat.
Can ChatGPT deep research use my Folio wiki?
Folio exposes search and fetch tools under the names ChatGPT deep research looks for, so it can. ChatGPT can send what it reads to OpenAI, so connect only the spaces you are happy to share, and choose read when you only need answers.
Can ChatGPT connect to Folio with a token?
No. ChatGPT cannot send a static token or custom header, so the route is OAuth. OpenAI's coding agent, Codex, does take a token.
Does my Folio need a public address for ChatGPT?
Yes, an HTTPS address reachable from the internet. For private networks OpenAI offers a Secure MCP Tunnel; check OpenAI's documentation for your plan.