Gumroad

You can run a Gumroad MCP Server to let AI assistants interact with Gumroad data and actions. This server connects through MCP, enabling tools to fetch products, sales, and offer codes, and to manage product status or user data via natural prompts.

How to use

You interact with the Gumroad MCP Server through an MCP-compatible client. After you configure the server, you can ask your client to perform tasks like listing products, viewing sales trends, generating offer codes, or enabling and disabling products. The server handles authentication and API calls to Gumroad, returning structured results that your AI client can visualize or summarize.

How to install

Prerequisites include Node.js 18 or later and a Gumroad account with API access. You also need an MCP-compatible client such as Claude Desktop.

Install the Gumroad MCP Server using the standard MCP setup flow for your client. The following steps cover the most common path using the MCP helper via npx.

npx gumroad-mcp@latest init

Configuration, security, and startup notes

To run the server, you must provide a Gumroad access token for authentication. You can either pass the token directly in the MCP configuration or use environment variables when starting the server.

If you run a self-hosted Gumroad instance, you can point the server to a custom base URL. The server will automatically append /v2 to the base URL for API requests.

{
  "mcpServers": {
    "gumroad": {
      "command": "npx",
      "args": ["-y", "gumroad-mcp@latest"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "GUMROAD_BASE_URL": "<YOUR_BASE_URL>"
      }
    }
  }
}

Examples of common tasks you can do with Gumroad MCP Server

• Get a list of all products, then iterate through them to check status, prices, and visibility.

• Retrieve sales data and generate charts or summaries to compare last month with the previous year.

• Work with offer codes: list all codes for a product, create new codes, update existing ones, or delete codes you no longer need.

How to authorize and start using Claude Desktop with Gumroad MCP

If you use Claude Desktop, start with an interactive setup to configure the Gumroad MCP Server automatically via an in-client setup flow.

npx gumroad-mcp@latest init

Available tools

gumroad_get_products

Get all Gumroad products including IDs, names, and statuses.

gumroad_get_product

Get a single product by its ID, returning details such as price, status, and stock.

gumroad_disable_product

Disable a product so it is no longer purchasable until re-enabled.

gumroad_enable_product

Enable a previously disabled product to make it purchasable again.

gumroad_get_sales

Retrieve sales data to analyze performance over a given period.

gumroad_get_offer_codes

Get all offer codes for a specific product.

gumroad_get_offer_code

Retrieve a single offer code by its identifier.

gumroad_create_offer_code

Create a new offer code for a product with specific discount and terms.

gumroad_update_offer_code

Update an existing offer code's properties.

gumroad_delete_offer_code

Delete an existing offer code.

gumroad_get_user

Fetch data for the authenticated Gumroad user.