incomeos — Model Context Protocol (MCP) Server

The io.github.Perufitlife/incomeos MCP server helps answer questions about earnings across multiple income streams. It supports data sources including Stripe, affiliates, app stores, ads, and manual inputs, enabling consolidated responses about “what you earn” in those categories.

🛠️ Key Features

Queries earnings across every income stream
Covers Stripe, affiliates, app stores, ads, and manual entries

🚀 Use Cases

Summarize income from Stripe transactions
Combine affiliate revenue with app store earnings
Track advertising revenue alongside manually recorded income

⚡ Developer Benefits

Clear scope of supported income sources
Focused description of the server’s purpose: earnings aggregation by stream

⚠️ Limitations

Only the listed income sources are described (Stripe, affiliates, app stores, ads, manual)
No additional configuration, tools, authentication, or data formats are provided in the available server data

Setup

Using the hosted version (fastest)

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"
      }
    }
  }
}

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"
  }
}

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.

Install

Configuration

Environment variables

INCOMEOS_URLrequired

https://app.incomeos.dev for the hosted version, or your own self-hosted deployment URL

INCOMEOS_TOKENrequiredsecret

API token from Dashboard -> Security (hosted), or your DASHBOARD_TOKEN (self-hosted)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "incomeos": {
      "command": "npx",
      "args": [
        "-y",
        "incomeos-mcp@0.2.2"
      ],
      "env": {
        "INCOMEOS_URL": "<YOUR_INCOMEOS_URL>",
        "INCOMEOS_TOKEN": "<YOUR_INCOMEOS_TOKEN>"
      }
    }
  }
}

incomeos — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

incomeos-mcp

Setup

Using the hosted version (fastest)

Self-hosting

Tools

Install

Configuration