Codex · Foliade
Create a flipbook with Codex MCP
Ask Codex to prepare a PDF catalogue, then turn it into a flipbook with Foliade. The MCP connector sends the selected file and lets you publish a reading link after your approval.
Install the plugin, connect your account and authorize access. No local server, API key or Python installation is required.
MCP is included for free, with or without an account. Codex and Claude Code follow your plan permissions; their own access terms remain separate.
Before each transfer, the assistant checks the account or guest mode and explains the limits returned by Foliade. The draft remains private until you request publication.
From PDF to interactive catalogue
A flipbook is a document you can read in a browser by turning its pages. Foliade converts your PDF into an interactive catalogue; the assistant prepares the content and runs the MCP tools. Check the text, images and links before sharing it.
Understand the flipbook format · Explore interactive catalogues
1. Install the Foliade plugin
In a terminal with a recent version of Codex, run these two commands:
codex plugin marketplace add https://gitlab.com/gekkode-public/foliade-connectors.git
codex plugin add foliade@foliadeThis public marketplace is maintained by Foliade. It is not a listing in the official OpenAI or Anthropic directories, which require a separate review.
View connector sourcesReplace an older plugin installation
Remove the plugin and its local marketplace using the commands below, then follow the installation steps above. Your Foliade catalogues are not deleted.
codex plugin remove foliade@foliade
codex plugin marketplace remove foliade2. Connect your account
OAuth sign-in is optional for a guest upload and required to access your account, including a free account. The server checks permissions for every action; an expired connection never becomes guest access.
Installing the plugin does not connect your account yet. After installation, run this command in your computer's terminal, outside the Codex conversation:
codex mcp login foliadeOn the Foliade page that opens, sign in, check the account email and authorize the connection. Then return to your assistant.
If the browser does not open, open the link shown in the terminal. Do not share this sign-in link.
Wait for the terminal to confirm that login succeeded before continuing. There is no API key to copy.
Open a new Codex task. Then enter this command in the conversation to check server status:
/mcpThis command displays server status; it does not replace signing in to your account.
In the Codex app, the Connect button in the Foliade plugin details or MCP settings can also authorize the same access.
If your organization disables plugins, MCP servers or network access, its administrator must authorize this integration.
3. Check before sending a PDF
To try without an account, ask the assistant to check guest mode and its limits, then convert the selected PDF to a private draft without publishing it.
Check the connected Foliade account, then list my catalogs. Don't change anything.
The assistant must use the Foliade tools and show your email address. Installing a plugin does not yet prove that your account is connected.
Generate a PDF named test and send it to my Foliade account as a private draft.
The plugin transfers only the selected PDF, waits for conversion and returns the draft link. This link requires the owner to be signed in. Explicitly request publication to get a public link.
Publish the draft I just approved and give me its public reading link.
Questions about flipbooks and MCP
What is the difference between the plugin and the MCP server?
The MCP server makes Foliade tools available to the assistant. The plugin adds their configuration and instructions for transferring a local PDF. Install the plugin to follow this guide; you do not need to host a server.
Can I create a flipbook for free without an account?
Without an account, on the website or through MCP: 3 PDFs per IP per 24 hours, 50 MB and 100 pages per PDF, one upload in progress. Publication lasts 30 days; private management lasts 30 minutes. Keep the private link to attach the catalogue to an account before it expires.
If Foliade does not appear
Check that the plugin is installed and enabled, reconnect your account, then open a new task. The assistant must never substitute pCloud or another service for Foliade.
If authentication is required, expired or revoked, run the login command from step 2 again. If the Foliade server cannot be found, complete the plugin installation first.
These guides cover Codex and Claude Code with local file access. They do not guarantee attachment transfers in ChatGPT, Claude web, Claude Desktop or Cowork.
Control and revoke access
In Foliade → API → Connected assistants, you can revoke each connection. Access ends immediately without deleting your catalogues.
The connection expires after 30 days. Then reconnect your account. The REST API keys are independent.
Manage my connectionsAdvanced alternative: add only the MCP server
Choose this method or the plugin, never both. The plugin adds instructions for transferring local PDFs.
codex mcp add foliade --url https://foliade.gekkode.com/mcp
codex mcp login foliadeRun the add-server command first, then the login command. Authorize access in your browser before returning to the assistant.
An old local installation must be removed before this replacement. Revoke its old API key if no other applications are using it.
Install in Codex · Install in Claude Code · Service Status