Gumroad MCP

🚀 Gumroad MCP Server

An implementation of the Model Context Protocol (MCP) server for Gumroad, enabling MCP-compatible AI clients to interact with the Gumroad API.

🚀 Quick Start

Start using the Gumroad MCP server in seconds with Claude Desktop:

npx gumroad-mcp@latest init

This command sets up the MCP server through interactive prompts, using your Gumroad credentials.

✨ Features

Basic Features

• Initialization: npx gumroad-mcp@latest init
• Get Credentials: npx gumroad-mcp@latest credentials
• List Products: npx gumroad-mcp@latest products
• Order History: npx gumroad-mcp@latest orders

Advanced Features

• Custom Fields: Support for extended data fields
• Batch Processing: Support for processing multiple orders at once
• Filters: Filter data by conditions such as date and product ID
• Export: Export data in CSV or JSON format

📦 Installation

Basic Installation

For most users, run the following command:

npx gumroad-mcp@latest install

Manual Installation

If you need custom configuration, refer to the following example:

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

If you are using a self-hosted Gumroad instance, you can configure a custom address 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"
      }
    }
  }
}

⚠️ Important Note

The server will automatically append the API version (/v2) to the base URL. For example, using GUMROAD_BASE_URL="https://example.com", API requests will be sent to https://example.com/v2.

Please refer to the MCP Protocol Documentation to learn how to add an MCP server in Claude Desktop.

💻 Usage Examples

Basic Usage

After configuration, try the following commands in an MCP-compatible client:

• How did my sales last month compare to a year ago?
• Generate an interactive chart of last year's sales.
• List Gumroad sales from last year.
• View sales data from the past seven days.

For more examples, refer to the Gumroad Documentation.

🤝 Contribution

Found a bug or have any suggestions? Please open an issue or submit a pull request on GitHub.

📄 License

This MCP server is released 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 refer to the LICENSE file in the project repository.