Gumroad
Connect to your Gumroad account to query sales, subscribers, and products. Filter by date range or email and page through results to answer revenue and customer questions fast. Retrieve individual records to power support, analytics, and automation.
Ask AI about Gumroad
Powered by Claude · Grounded in docs
I know everything about Gumroad. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Gumroad MCP Server
A Model Context Protocol (MCP) server for the Gumroad API, enabling AI assistants to look up subscription information, sales data, and product details.
Features
- Subscription Management: Get subscriber lists and individual subscriber details
- Sales Data: Query sales with filters (date range, email, pagination)
- Product Information: Retrieve product listings and details
- Type-Safe: Written in TypeScript with comprehensive type definitions
- Smithery Compatible: Ready to deploy on Smithery.ai
Available Tools
Subscribers
get_subscribers- Get all subscribers for a specific productget_subscriber- Get details for a specific subscriber
Sales
get_sales- Get all sales with optional filters (date range, email, pagination)get_sale- Get details for a specific sale
Products
get_products- Get all your Gumroad productsget_product- Get details for a specific product
Installation
Using Smithery (Recommended)
- Visit Smithery.ai
- Search for "gumroad-mcp" or install directly from this repository
- Configure with your Gumroad access token
- Deploy and use in Claude Desktop or other MCP clients
Manual Installation
# Clone the repository
git clone <your-repo-url>
cd gumroad-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Run the server
GUMROAD_ACCESS_TOKEN=your_token_here npm start
Configuration
Getting Your Gumroad Access Token
- Go to https://gumroad.com/api
- Click "Create an application"
- Generate an access token
- Copy the token for use in configuration
Environment Variables
GUMROAD_ACCESS_TOKEN(required) - Your Gumroad API access token
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"gumroad": {
"command": "node",
"args": ["/path/to/gumroad-mcp/dist/index.js"],
"env": {
"GUMROAD_ACCESS_TOKEN": "your_token_here"
}
}
}
}
Usage Examples
Get Product Subscribers
Get all subscribers for product ID "abc123"
The assistant will call get_subscribers with product_id: "abc123".
Query Sales by Email
Show me all sales for customer@example.com
The assistant will call get_sales with email: "customer@example.com".
Get Sales in Date Range
Show me all sales from January 2025
The assistant will call get_sales with appropriate after and before timestamps.
API Response Examples
Subscriber
{
"id": "sub_123",
"product_id": "prod_abc",
"product_name": "My Product",
"user_email": "customer@example.com",
"status": "alive",
"recurrence": "monthly",
"created_at": "2025-01-01T00:00:00Z"
}
Sale
{
"id": "sale_123",
"email": "customer@example.com",
"product_name": "My Product",
"price": 2900,
"formatted_display_price": "$29",
"timestamp": "2025-01-01T00:00:00Z",
"is_recurring_billing": true,
"subscription_id": "sub_123"
}
Development
# Install dependencies
npm install
# Build in watch mode
npm run dev
# Build for production
npm run build
# Run the server
npm start
API Permissions
The server requires a Gumroad access token with the following scopes:
view_sales- To read sales and subscription dataview_profile- To read product information
Error Handling
All tools include comprehensive error handling. If an API call fails, you'll receive a descriptive error message explaining what went wrong.
License
MIT
