How to connect Gumroad to Codex

1. 1. Enable Gumroad in Metorial

   In your Metorial portal, enable the Gumroad MCP server and sign in with the account that owns the data. Access stays governed by your team policies.

2. 2. Add the server and sign in

   The Codex CLI, IDE extension and ChatGPT desktop app share this config.

   Copy

   codex mcp add metorial --url <your-magic-mcp-url>
   codex mcp login metorial

3. 3. Check the connection

   Type /mcp in Codex to see Metorial and its Gumroad tools.

• List Products: Retrieve products from your Gumroad account.
• Manage Offer Codes: List, create, update, or delete discount offer codes for a Gumroad product.
• Manage Variants: Manage variant categories and individual variants on a Gumroad product.
• List Subscribers: Retrieve active subscribers for a specific Gumroad product.
• Get Sale: Retrieve detailed information about a specific Gumroad sale, including buyer details, product info, and transaction amounts.
• Manage License: Verify, enable, disable, decrement uses, or rotate a Gumroad license key.
• List Sales: Retrieve sales from your Gumroad account with optional filtering by date range, buyer email, buyer name, license key, product, or order ID.
• Get Subscriber: Retrieve detailed information about a specific Gumroad subscriber by their subscriber ID.
• Get User Profile: Retrieve the authenticated Gumroad user's profile information, including name, email, bio, profile URL, and profile picture.
• Manage Custom Fields: List, create, update, or delete custom fields on a Gumroad product.
• Manage Sale: Mark a sale as shipped, refund a sale, revoke or restore the buyer's access, or resend the purchase receipt.
• Get Product: Retrieve detailed information about a specific Gumroad product, including variant categories, custom fields, and tags.
• Manage Product: Create, update, enable, disable, or delete a Gumroad product.
• Get Payout: Retrieve details for a specific Gumroad payout, optionally including sale IDs and exported transaction rows.
• Get Upcoming Payouts: Retrieve upcoming Gumroad payouts for the authenticated user.
• And 5 more on the Gumroad MCP server page.

• Limit which Gumroad tools Codex sees with enabled_tools and disabled_tools on the metorial server in config.toml.
• Set default_tools_approval_mode to auto, prompt, writes or approve. writes prompts only for tools that are not marked read-only.
• Type /mcp in the composer to see the connected servers.
• Override the approval behavior for a single Gumroad tool with tools.<tool>.approval_mode.

Metorial is listed but tools are missing

Codex can connect without credentials and then see nothing. Run codex mcp login metorial to complete the OAuth sign-in.

Metorial times out at startup

Codex waits 10 seconds by default. Raise startup_timeout_sec under [mcp_servers.metorial] in ~/.codex/config.toml.

Long tool calls fail after a minute

The default tool timeout is 60 seconds. Raise tool_timeout_sec for the metorial server in config.toml.

Based on the Codex MCP documentation.