folosat-mcp

Connect AI assistants (Claude, ChatGPT, Cursor) to Folosat — your income allocation system, savings goals, group expenses, and wealth overview.

Available in English and Arabic — the only bilingual personal finance MCP server.

What this MCP server exposes

Resources (read-only data your AI can query)

| Resource | What it returns | |---|---| | folosat://buckets | Your 5-bucket income allocation — balances, targets, % used | | folosat://transactions/{period} | Categorized transactions for a period | | folosat://goals | All savings goals — progress, contribution history, projected completion | | folosat://groups/{id}/balances | Who owes whom in a group expense split | | folosat://wealth/networth | Net worth snapshot and time series | | folosat://budget/{id}/summary | Budget manager spending vs. plan |

Tools (actions, always require your approval)

| Tool | What it does | |---|---| | create_expense | Add a new expense to your account | | add_goal_contribution | Contribute to a savings goal | | get_cashflow_forecast | 30 or 60-day cash flow projection |

Built-in prompts

• /monthly_review — How was my spending vs. plan this month?
• /salary_allocation — I just got paid — how should I allocate it?
• /goal_check — Am I on track for all my savings goals?

Example conversations

Check your month:

"How did my spending look this month versus my plan?"

Plan a purchase:

"I want to buy a laptop for $800. Can I afford it without hurting my savings goals?"

Group trip:

"Did everyone settle up from the Dubai trip?"

Salary day:

"I just received my salary of 12,000 SAR. How should I split it across my buckets?"

Status

Coming soon. Full live integration is under active development.

The server spec and namespace are published. Authentication and live data access will be available in a future release.

Get Folosat to be notified when the MCP integration launches.

Installation (when available)

{
  "mcpServers": {
    "folosat": {
      "command": "npx",
      "args": ["folosat-mcp"]
    }
  }
}

Add this to your Claude Desktop config at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Philosophy

Folosat is built around the Income Growth System — not just tracking where your money went, but actively directing it toward growing what you earn. The 5-bucket allocation (Obligations / Investment / Personal / Reserve / Savings) gives every riyal and dollar a purpose before you spend it.

The MCP integration brings this system into your AI assistant — so you can ask natural questions about your finances and get answers grounded in your actual data.

Links

• Folosat app
• GitHub