Gumroad MCP Server
@rmarescu
A Model Context Protocol (MCP) server implementation for Gumroad API
Overview
What is Gumroad MCP Server?
Gumroad MCP Server is a Model Context Protocol (MCP) implementation that enables MCP-compatible AI clients, such as Claude Desktop, to interact with the Gumroad API. It allows users to manage products, sales, offer codes, and user data via natural language commands.
How to use Gumroad MCP Server?
Install using npx gumroad-mcp@latest init for an interactive setup, or manually configure your MCP client with the server command and a GUMROAD_ACCESS_TOKEN environment variable. For self-hosted Gumroad instances, optionally set GUMROAD_BASE_URL. After configuration, ask your AI client questions or give commands like “List my top-selling products” or “Disable Product X”.
Key features of Gumroad MCP Server
- Retrieve and manage Gumroad products
- Enable or disable products
- Query sales data
- Full CRUD for offer codes
- Access authenticated user information
Use cases of Gumroad MCP Server
- Ask for month-over-month sales trends
- Disable or enable products with voice commands
- Create discount offer codes for specific products
- List all offer codes associated with a product
- Retrieve a summary of recent sales activity
FAQ from Gumroad MCP Server
How do I get a Gumroad access token?
Go to Settings > Advanced in your Gumroad account, create a new application, and click “Generate access token.” Keep this token confidential.
What are the runtime requirements?
Node.js 18 or later and a Gumroad account with API access. An MCP-compatible client (e.g., Claude Desktop) is also required.
Can I use a self-hosted Gumroad instance?
Yes, set the GUMROAD_BASE_URL environment variable to your custom URL. The server automatically appends /v2 to the base URL for API requests.
How do I install this server on Claude Desktop?
Run npx gumroad-mcp@latest init for automatic setup, or manually add the server configuration to your MCP settings file with the command and access token.
What tools does the server provide?
It provides tools for products (get, enable, disable), sales (get sales), offer codes (get, create, update, delete), and retrieving authenticated user data.
