Connect Heyzine to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the manage password protection tool in Heyzine
Use the list flipbooks tool in Heyzine
Use the manage access list tool in Heyzine
Use the manage bookshelf tool in Heyzine
Use the create flipbook tool in Heyzine
Use the delete flipbook tool in Heyzine
Supported Tools
manage_password_protection
Manage Password Protection
Configures password protection settings for a flipbook. Supports multiple access modes including per-user credentials, a single shared password, Google Sign-In, password-only, one-time password (OTP), and email-based access.
You can also customize the login screen text for username and password prompts.
list_flipbooks
List Flipbooks
Retrieves all flipbooks in the account. Supports filtering by search term and tags to narrow results.
Returns flipbook metadata including title, URL, thumbnail, page count, tags, and creation date.
manage_access_list
Manage Access List
Adds or removes users from a flipbook's access list. Use this to control who can view a password-protected flipbook.
Supports multiple access types including username/password pairs, Google accounts, password-only, one-time passwords, and email-based access.
manage_bookshelf
Manage Bookshelf
Lists bookshelves, lists flipbooks within a bookshelf, or adds/removes flipbooks from a bookshelf.
Bookshelves are collections of flipbooks displayed on a shared page.
create_flipbook
Create Flipbook
Converts a PDF, DOCX, or PPTX file into an interactive digital flipbook with page-turning effects.
Supports both **synchronous** (waits for conversion) and **asynchronous** (returns immediately) modes.
You can customize the flipbook appearance including title, subtitle, logo, background color, and UI controls.
Use a template flipbook ID to copy styling from an existing flipbook.
delete_flipbook
Delete Flipbook
Permanently deletes a flipbook from the account. This action cannot be undone.
get_oembed
Get oEmbed Data
Retrieves oEmbed 1.0 data for a flipbook URL, returning embed HTML, dimensions, and thumbnail information.
Useful for embedding flipbooks in third-party platforms that support oEmbed discovery.
get_flipbook
Get Flipbook
Retrieves detailed information about a specific flipbook including its metadata, links, thumbnail, page count, tags, oEmbed data, and optionally its embed code.
update_social_metadata
Update Social Metadata
Updates the social sharing metadata (title, description, thumbnail) for a flipbook or bookshelf.
This controls how the resource appears when shared on social media platforms via Open Graph tags.
update_flipbook_design
Update Flipbook Design
Updates an existing flipbook’s reader appearance, controls, metadata, and tags. A template copies styles first; explicitly provided settings override the template.
Enable Heyzine in Metorial. In your Metorial portal, enable the Heyzine MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Heyzine tools.
Enable Heyzine in Metorial. In your Metorial portal, enable the Heyzine MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Heyzine tools.
Enable Heyzine in Metorial. In your Metorial portal, enable the Heyzine MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Heyzine tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Heyzine in Metorial. In your Metorial portal, enable the Heyzine MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Heyzine tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Heyzine in Metorial. In your Metorial portal, enable the Heyzine MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Heyzine tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Heyzine through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Heyzine and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Heyzine tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Convert PDF, DOCX, and PPTX files into interactive digital flipbooks with page-turning effects. Create flipbooks programmatically from document URLs with customizable styling, titles, logos, and UI controls. List, retrieve details, update designs, and delete flipbooks. Organize flipbooks into bookshelves by adding, removing, and reordering them. Configure social media metadata (title, description, thumbnail) for flipbooks and bookshelves. Protect flipbooks with password-based access control including per-user credentials, single passwords, Google Sign-In, OTP, and email-based access. Retrieve oEmbed data for embedding flipbooks in third-party platforms.
Frequently asked questions
Common questions about connecting Heyzine to AI agents with Metorial.
How many tools does the Heyzine MCP server have?
The Heyzine MCP server exposes 10 tools, including Manage Password Protection, List Flipbooks, Manage Access List. Each one is governed and traced through Metorial.
Does the Heyzine MCP server support triggers?
Heyzine exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Heyzine MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Heyzine MCP server through the same Metorial URL.
How do I give only some teams access to Heyzine?
Use role-based access control to decide which teams, users, and agents can use Heyzine and which of its tools they can call.
Can I self-host the Heyzine MCP server?
Yes. Metorial is open source, so you can run the Heyzine MCP server yourself or use the hosted gateway.
Connect Heyzine to production AI agents
See how Metorial gives your team governed access to Heyzine, with tracing and security controls built in.