Incomeos MCP server
Ask what you earn across every income stream: Stripe, affiliates, app stores, ads, manual.
1 stars21 downloads/wk
Reviews
Write oneNobody has reviewed Incomeos yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Incomeos tools (4)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_income_summaryGet a summary of total passive income: average per day, this month, this year, all-time, plus the top sources and goal progress.
get_monthGet the income breakdown for a specific month (YYYY-MM): total and per-source.
get_sourcesList all income sources with their amount this month, this year, and all-time.
log_monthly_incomeLog (or overwrite) the income total for a source for a given month. Use 0 to clear it.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 44 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Incomeos compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 67% of 2,170 E-commerce servers
- Tools
- 4
- the typical E-commerce server has 6
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 1,049 E-commerce servers
- Downloads a week
- 21
- more than 7% of 412 E-commerce servers with a package
What its tools let an agent do: 4 read
Install Incomeos in Claude Code, Cursor or VS Code
Runs npx -y incomeos-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add incomeos -- npx -y incomeos-mcp
What the publisher says
From the Incomeos repository's README, as published. We do not edit it. Read it on GitHub
💰 IncomeOS — one screen for every dollar you make
Most revenue dashboards assume you have one product on one Stripe account. IncomeOS assumes what's actually true for an indie hacker: a SaaS on Stripe, an Amazon affiliate link, a marketplace actor, a mobile app, a sponsorship — I track 25 sources, and most of them make under $10 a month. Nothing adds them up.
→ See it running on my real numbers — my own income, live, not demo data.
Self-hosted and MIT. Your revenue lives in your Supabase project — no third party ever sees your numbers. Deploy free on Vercel in about five minutes, or use the hosted version if you'd rather not maintain infrastructure.
Ask your AI how much you made
This is the part nothing else does. IncomeOS ships an MCP server, so Claude, Cursor, or any MCP client can read your income on demand:
"How much did I make this month across everything?"
"Which source grew the most since May?"
"Log $180 for Amazon affiliates in July."
{
"mcpServers": {
"incomeos": {
"command": "npx",
"args": ["-y", "incomeos-mcp"],
"env": { "INCOMEOS_URL": "https://your-incomeos.vercel.app", "INCOMEOS_TOKEN": "your-token" }
}
}
}Tools: getincomesummary, getsources, getmonth, logmonthlyincome. See mcp/. The MCP talks to your instance with your token — the data never leaves it.
What it does
tail has no API and never will; typing it beats not tracking it.
- 🔢 Numbered sources — #1 SaaS, #2 Amazon, #3 Sponsorship…
- ⚡ Stripe on autopilot — net revenue after fees, auto-grouped per product.
- ✍️ Everything else in 10 seconds — one monthly total per source. The long
still show an honest "avg per day".
- 📅 Day / month / year, with pro-rated averages so monthly-only sources
- 📈 Month-over-month trend per stream, and 🎯 goals with live progress.
Dashboard screenshots use demo data. The public page above is real.
Quickstart (~5 min)
in the SQL editor.
- Create a Supabase project (free) and run supabase/migrations/0001_init.sql
.env.example: SUPABASEURL, SUPABASESERVICEROLEKEY, DASHBOARDTOKEN (your password), CRONSECRET, and optionally STRIPESECRETKEY (a read-only restricted key is plenty).
- Deploy to Vercel (or npm run dev) with the env vars from
own; add the rest with ➕ Add source.
- Open it, sign in, hit Sync. Stripe products show up as sources on their
A daily Vercel Cron keeps Stripe fresh; the Sync button pulls on demand.
Connectors
Every source can hold a link to its own dashboard — clicking the card opens it.
Self-hosted vs hosted
This repo is the self-hosted build: Stripe, manual sources, all the charts, goals, and the MCP. Free forever, no feature held back to sell you something.
app.incomeos.dev is the hosted build, and it's ahead of this repo on a few things I run for myself: RevenueCat sync, a weekly email digest, the public page linked at the top, and email-link sign-in instead of a shared password. Free tier covers unlimited manual sources, every chart, and sync on demand; Pro is $9/mo and adds automatic daily sync.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Incomeos: common questions
- Is Incomeos MCP server safe?
- Mostly: it is graded B (78/100). Read the Incomeos safety report
- How do I install Incomeos?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Incomeos need an API key?
- Yes. The registry entry asks for
INCOMEOS_TOKEN. - Is Incomeos maintained?
- The last commit was 86 days ago (2026-08-11). The latest release is v0.2.2.
- What can I use instead of Incomeos?
- Servers from other publishers that do the same job: Kagura Memory Cloud MCP server, Asc MCP server and Apify MCP server.
- How does Incomeos compare with other E-commerce MCP servers?
- safety score 78/100 (higher than 67% of 2,170 E-commerce servers); tools 4 (the typical E-commerce server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Incomeos
Same job from other publishers: the closest match first, then the best rated.
- Kagura Memory CloudPersistent memory for AI assistants: store, search, and connect knowledge across conversations.not reviewedGrowingA
- AscAsk your AI to check, fix and submit your App Store release. 41 tools for the paperwork.not reviewedGrowingB
- ApifyExtract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡not reviewedEstablishedA
- StripeMCP server integrating with Stripe - tools for customers, products, payments, and more.not reviewedEstablishedA
- Mneme MemoryCross-session memory for AI coding agents via six tools; local-first SQLite store.not reviewedEstablishedA