IncomeOS MCP Server (io.github.Perufitlife/incomeos)

This Model Context Protocol (MCP) server for IncomeOS lets an AI agent ask how much you earn across multiple income streams. It supports sources like Stripe, affiliates, app stores, ads, and manual entry, and is used to answer prompts such as monthly totals or specific dates.

🛠️ Key Features

Ask for income across all income streams (Stripe, affiliates, app stores, ads, manual)
Topic-aligned capabilities: dashboard, income tracking, revenue dashboard
Includes a hosted setup at app.incomeos.dev with API token creation

🚀 Use Cases

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

⚡ Developer Benefits

Fits Model Context Protocol workflows
Supports self-hosted use per the project topics (self-hosted listed)
Works with revenue/analytics tooling concepts (baremetrics-alternative listed)

⚠️ Limitations

Hosted setup is described as sign-in at app.incomeos.dev and connecting Stripe read-only or adding sources manually

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

io.github.Perufitlife/incomeos

IncomeOS MCP Server (io.github.Perufitlife/incomeos)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

incomeos-mcp

Setup

Using the hosted version (fastest)

Self-hosting

Tools

Install

Configuration

Related servers