gumroad-mcp

Read-only MCP server for your Gumroad store — products, sales, and revenue summaries, exposed as tools your AI agent can call.

Built by a store operator, not from the API docs alone:

• Sales are fully paginated. The v2 sales endpoint pages by page_key; naive clients read page 1 and silently under-report. This server walks every page (with a hard cap so a huge store can't hang a session).

• Money is integer cents + a formatted string. Models shouldn't do float arithmetic on revenue.

• Refunds are first-class. sales and revenue_summary report gross and net-of-refunds.

• Buyer privacy by default. Sales rows expose the buyer's email domain only — enough for channel analysis, no PII handed to the model.

• Read-only by design. Only GET endpoints. The token comes from the environment and is never echoed or logged.

Tools

Related MCP server: SimpleShop MCP

Install

git clone https://github.com/stcmain/gumroad-mcp.git
cd gumroad-mcp
pip install .

Get a token: Gumroad → Settings → Advanced → Applications → create app → copy the access token.

Register with Claude Code:

claude mcp add --scope user gumroad --env GUMROAD_ACCESS_TOKEN=your_token -- gumroad-mcp

Or any MCP client config:

{
  "mcpServers": {
    "gumroad": {
      "command": "gumroad-mcp",
      "env": { "GUMROAD_ACCESS_TOKEN": "your_token" }
    }
  }
}

License

MIT © Zachary Pampu