Gumroad MCP Server

Overview

A Model Context Protocol (MCP) server implementation for Gumroad, enabling MCP-compatible AI clients like Claude Desktop to interact with Gumroad API.

The Model Context Protocol (MCP) allows AI assistants to interact with external tools and services.

Quickstart

Start using Gumroad MCP Server with Claude Desktop in seconds:

npx gumroad-mcp@latest init

This command sets up the MCP server with your Gumroad credentials through an interactive prompt.

Usage

Once configured, try these commands in your MCP-compatible client:

How many sales did I make last month vs a year ago?
Generate an interactive chart with last year's sales
List my top-selling products on Gumroad from last year
Show month-over-month trend of my top-selling product last year
Disable "Product Name" product
Enable "Product Name" product
List all offer codes for "Product Name"
Create a new offer code "FAFO" with 99% off for "Product Name"
Delete offer code "abc123" from "Product Name"

Tools

Products

gumroad_get_products - Get all products
gumroad_get_product - Get a single product by ID
gumroad_disable_product - Disable a product
gumroad_enable_product - Enable a product

Offer Codes

gumroad_get_offer_codes - Get all offer codes for a product
gumroad_get_offer_code - Get a single offer code
gumroad_create_offer_code - Create a new offer code
gumroad_update_offer_code - Update an existing offer code
gumroad_delete_offer_code - Delete an offer code

User

gumroad_get_user - Get authenticated user data

Installation

Installing via Smithery

To install gumroad-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @rmarescu/gumroad-mcp --client claude

Prerequisites

Node.js 18 or later
A Gumroad account with API access
An MCP-compatible client (like Claude Desktop)

To verify you have Node installed, open the command line on your computer.

On macOS, open the Terminal from your Applications folder
On Windows, press Windows + R, type "cmd", and press Enter

Once in the command line, verify you have Node installed by entering in the following command:

node --version

Generate a Gumroad access token

Gumroad API requires authentication. To generate an access token, follow these steps:

Log in to your Gumroad account (or your own instance of Gumroad).
Go to Settings > Advanced page.
Create a new application by providing the following information:
- Application icon (optional): A small thumbnail image to identify your application.
- Application name: A name for your application.
- Redirect URI: For personal use, you can enter http://127.0.0.1 (localhost) as this value is not meaningful in this context.
Click "Create application."
Use the "Generate access token" button to get your access token.

Keep your access token safe and confidential, like a password. You'll need to include it in your configuration as shown below.

Claude Desktop installation

If you use Claude Desktop, you can use the interactive setup:

npx gumroad-mcp@latest init

Manual installation

For other MCP-enabled applications, you will need to update the MCP configuration manually.

Example config

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

If you're using a self-hosted Gumroad instance, you can configure the server to connect to your custom URL via GUMROAD_BASE_URL:

{
  "mcpServers": {
    "gumroad": {
      "command": "npx",
      "args": ["-y", "gumroad-mcp@latest"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "GUMROAD_BASE_URL": "https://example.com"
      }
    }
  }
}

[!NOTE] The server automatically appends the API version (/v2) to your base URL. For example, with GUMROAD_BASE_URL="https://example.com", API requests will be sent to https://example.com/v2.

Please refer to these instructions on how to add the MCP Server to Claude Desktop.

Contributing

Found a bug or want to suggest a feature? Please open an issue or submit a pull request on GitHub.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.