Incomeos

io.github.PerufitlifePublished by GitHub account Perufitlifev0.2.2Updated Oct 24, 2026

Ask what you earn across every income stream: Stripe, affiliates, app stores, ads, manual.

VerifiedSTDIODesktop onlyFinance Data & Analytics

Server details

Identifier: io.github.Perufitlife/incomeos
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account Perufitlife for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.Perufitlife%2Fincomeos.svg)](https://sourceweft.com/mcp/io.github.Perufitlife%2Fincomeos?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Lets an assistant query and log income across multiple streams, such as Stripe, affiliates, app stores, and ads, through an IncomeOS instance.

What you can do: The server exposes tools for reading and writing income data in an IncomeOS account. get_income_summary returns averages per day, this month, this year, all-time totals, top sources, and goals. get_sources lists every source with month, year, and all-time amounts, and get_month gives a per-source breakdown for a specified YYYY-MM. log_monthly_income sets or overwrites a source's total for a month, with 0 clearing it.
When to use it: Useful when you track income from several places and want to ask an assistant for totals or monthly breakdowns in natural language, or to record a monthly figure without opening the dashboard. It fits personal or small-business income tracking rather than accounting or tax reporting.
Requirements: Runs locally via npx from the npm package incomeos-mcp, so Node.js is needed. Requires INCOMEOS_URL, set to for the hosted version or your own deployment URL, and INCOMEOS_TOKEN, an API token from the dashboard's Security page or your DASHBOARD_TOKEN when self-hosting. A hosted account is free and can connect Stripe read-only or accept manual sources.

Before you install

The INCOMEOS_TOKEN is a secret credential and should be kept out of shared configuration. log_monthly_income writes to your income records and overwrites a source's total for a month, so a wrong value can replace existing data. Connecting Stripe is described as read-only, but the server still sends your token and queries to the configured IncomeOS instance.

Installation

In SourceWeft

Open Incomeos in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

incomeos-mcp

MCP server for IncomeOS. Ask your AI agent how much you're making across all your income streams.

"How much did I make this month?" · "Show my income for 2026-05" · "Log $40 of Amazon affiliate income for last month"

Setup

Using the hosted version (fastest)

Sign in at app.incomeos.dev — free, no card.
Connect Stripe read-only, or add any source manually.
Open Security → Create API token and copy it.

json

{  "mcpServers": {    "incomeos": {      "command": "npx",      "args": ["-y", "incomeos-mcp"],      "env": {        "INCOMEOS_URL": "https://app.incomeos.dev",        "INCOMEOS_TOKEN": "iok_your_token_here"      }    }  }}

{  "mcpServers": {    "incomeos": {      "command": "npx",      "args": ["-y", "incomeos-mcp"],      "env": {        "INCOMEOS_URL": "https://app.incomeos.dev",        "INCOMEOS_TOKEN": "iok_your_token_here"      }    }  }}

Self-hosting

Same config, but point INCOMEOS_URL at your own deployment and use your DASHBOARD_TOKEN:

json

{  "env": {    "INCOMEOS_URL": "https://your-incomeos.vercel.app",    "INCOMEOS_TOKEN": "your-DASHBOARD_TOKEN"  }}

{  "env": {    "INCOMEOS_URL": "https://your-incomeos.vercel.app",    "INCOMEOS_TOKEN": "your-DASHBOARD_TOKEN"  }}

Tokens are stored hashed, show a last-used timestamp, and can be revoked individually from the dashboard.

Tools

Tool	What it does
`get_income_summary`	Avg/day, this month, this year, all-time + top sources + goals
`get_sources`	Every source with month / year / all-time amounts
`get_month`	Per-source breakdown for a given `YYYY-MM`
`log_monthly_income`	Set/overwrite a source's total for a month (0 clears it)

Your data never leaves your own IncomeOS instance — the MCP just calls its API with your token. MIT licensed.

Source: mcp/README.md at commit 3e54ccb

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts