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)

1. Sign in at app.incomeos.dev — free, no card.
2. Connect Stripe read-only, or add any source manually.
3. 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.