incomeos-mcp

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.

{
  "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:

{
  "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.