Budget Tracker by Smart Money
ink.smart-money由 smart-money.ink 發布官方發布者v0.2.3更新於 Oct 24, 2026
Personal finance: log expenses in plain language, track accounts, budgets and spending
概覽
遠端 OAuth 保護的 MCP 伺服器,讓助理用自然語言記帳,並管理個人財務帳本中的帳戶、預算、存款與支出。
- 可以做什麼
- 預覽並記錄交易:解析自然語言輸入或貼上的銀行通知,再新增、列出、修改或刪除交易
- 產生財務報表:依期間提供收入、支出、儲蓄率、分類明細與主要商家
- 管理帳戶與餘額:金融卡、現金、銀行帳戶、存款、信用卡與電子錢包,並計提利息
- 整理分類、標籤與預算:提供建立、修改與刪除工具
- 適用情境
- 適合想透過對話記錄開銷、並在聊天用戶端查詢自身財務狀況的人,不必開啟理財應用程式。適用於已在使用或願意訂閱 Smart Money 記帳服務的使用者。
- 執行需求
- 遠端端點 smart-money.ink/mcp,使用 Streamable HTTP,無需本機安裝。需要 Smart Money 帳戶及有效訂閱或 7 天免費試用(需綁定信用卡)。首次使用時透過 OAuth 2.1 與 PKCE 授權,無需 API 金鑰或環境變數。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Budget Tracker by Smart Money,將其新增到工作區。
- 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
- 為需要使用其工具的對話啟用該服務。
Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
交給代理程式安裝
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/ink.smart-money%2Fsmart-money/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。其他 MCP 客戶端
把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。
{
"mcpServers": {
"budget-tracker-by-smart-money": {
"type": "http",
"url": "https://smart-money.ink/mcp"
}
}
}README
en • ru
Budget Tracker by Smart Money MCP
Model Context Protocol server for personal finance — log expenses in plain language, track accounts, deposits, budgets and spending, secured by OAuth.
Budget Tracker by Smart Money MCP puts your money ledger inside your AI assistant. Connect Claude, ChatGPT, Cursor, VS Code, or a CLI client to Budget Tracker by Smart Money, then say "log 4500 on a taxi yesterday from Kaspi" or ask "how much did I spend on food this month?" — the assistant writes to the same ledger the app reads.
- Server URL:
https://smart-money.ink/mcp - Transport: Streamable HTTP
- Auth: OAuth 2.1 with PKCE
- Landing & setup: smart-money.ink/claude
Install
Budget Tracker by Smart Money MCP is a remote, OAuth-secured server. There is nothing to install locally. Add this to your MCP client config:
One-click install:
[Add to Cursor] [Add to VS Code] [Add to Claude] [Add to ChatGPT]
CLI clients (Claude Code, Gemini CLI, Codex CLI) and manual snippets: see Supported clients.
Quick start
- Create a Budget Tracker by Smart Money account at smart-money.ink and start the free trial (see Plans & access).
- Open smart-money.ink/claude and follow the setup path for your client.
- Use the one-click install, the CLI command, or the manual JSON snippet above.
- Authorize with OAuth when your client opens the consent screen.
- Talk to your assistant about money in plain language.
What you can do from chat
- 💬 Plain-language entry —
taxi 4500 yesterday kaspi #tripis parsed into an amount, date, account, currency, tags and category. Amounts like12kor1.2m, dates likeyesterdayor3 days ago, and account names in any script all resolve. - 📊 Spending answers — income, expense, savings rate, category breakdown and top merchants for any period.
- 🏦 Accounts & balances — cards, cash, bank accounts, deposits, credit cards (counted as liabilities), investments and e-wallets. Multi-currency, with rates on the date and totals in your base currency.
- 💰 Deposits with interest — rate in basis points, accrual frequency, compounding or payout to another account. Interest is computed daily on the real balance, and every accrual carries an idempotency key, so nothing is posted twice.
- 🎯 Budgets — weekly, monthly or yearly limits with spent, remaining, and an end-of-period forecast.
- 📥 Bank notifications — paste push-notification text and it becomes transactions; re-importing the same notification does not duplicate it.
- 🏷️ Categories & tags — flat categories chosen in one step, tags orthogonal to them. An unknown
#tagis created on the fly; a deleted one is restored instead of duplicated.
Tool surface
27 tools. Reading and writing are separate tools — no confirm or dryRun flags — and each one carries a title plus readOnlyHint / destructiveHint annotations, so your client knows which calls deserve a confirmation prompt.
Deletion is soft: a transaction gets a deletedAt and drops out of balances and reports on every device, while its import key stays — so re-importing the same bank notification will not bring it back. An account or category still referenced by transactions cannot be deleted; the connector offers to archive it instead, so history never points at nothing.
For the exact, up-to-date set, run tools/list against https://smart-money.ink/mcp.
Plans & access
Budget Tracker by Smart Money is a paid service with a free trial. The connector reads and writes your real ledger, so it needs an active subscription or trial — there is no anonymous tier.
Nothing is charged during the trial, and cancelling during it charges nothing. Cancel any time in Settings → Subscription. When a subscription lapses the app locks, but records are not deleted: they stay in your browser and can still be exported. Current terms: smart-money.ink/terms.
Call a tool without an active subscription and the tool result says so, pointing you at the app's settings.
Supported clients
- Claude (web & desktop) — Settings → Connectors → Add custom connector
- ChatGPT — Settings → Connectors → custom MCP connector with OAuth
- Cursor — one-click install via deeplink, or
~/.cursor/mcp.json - VS Code — one-click install via deeplink, or
.vscode/mcp.json - Claude Code (CLI) —
claude mcp add --transport http smart-money https://smart-money.ink/mcp - Gemini CLI —
gemini mcp add --transport http smart-money https://smart-money.ink/mcp - Codex CLI —
codex mcp add smart-money --url https://smart-money.ink/mcp - Generic HTTP MCP client — point it at the URL and let it complete OAuth discovery
Full per-client instructions: docs/setup.md.
Cursor plugin
This repository is also a Cursor plugin. It contributes one MCP server (smart-money) and no rules, skills, agents, or hooks.
There is nothing to configure. No API key or environment variable is required: the server advertises OAuth 2.1 metadata, the client registers itself dynamically, and the consent screen opens on first use.
Example prompts
Log as you go
"taxi 4500 yesterday kaspi #trip"
→ One transaction, parsed and saved: amount, date, account, tag. The preview tool can show the parse first.
Ask where the money went
"How much did I spend on food this month, and how does that compare to my budget?"
→ A category breakdown plus the budget's spent, remaining, and end-of-month forecast.
Deposits
"Post the interest due on my deposits."
→ Interest accrued daily on the actual balance, idempotent: running it twice posts nothing extra.
Bank notifications
(paste a batch of bank push notifications) "Turn these into transactions."
→ Parsed into transactions, with already-imported ones skipped.
More: docs/examples.md.
Authorization & data
Auth is OAuth 2.1 with PKCE. Your assistant gets a token tied to your Budget Tracker by Smart Money account, and the connector reads and writes as you — row-level security and the subscription check apply exactly as they do in the web app. Discovery follows RFC 9728: an unauthenticated call to /mcp returns 401 pointing at https://smart-money.ink/.well-known/oauth-protected-resource/mcp, and the authorization server is found from there.
Tokens can be revoked at any time from the Budget Tracker by Smart Money app. OAuth flow details: docs/oauth.md. Data handling: smart-money.ink/privacy.
Troubleshooting
Common connection, OAuth, and tool-call errors: docs/troubleshooting.md.
Where this server is listed
Registry and directory listings, and how publishing works: docs/registries.md.
Project links
- Product: smart-money.ink
- Setup page: smart-money.ink/claude
- MCP server:
https://smart-money.ink/mcp - Issues: github.com/ultraza4/smart-money-mcp/issues
License
MIT — see LICENSE.
Built by @ultraza4. Budget Tracker by Smart Money is a hosted personal-finance service; this repo is documentation and manifests for its public MCP server. Server source is not open.
來源:README.md,提交 c384600
工具
0版本歷史
2- v0.2.3最新Oct 23, 2026
- v0.2.1Sep 22, 2026
評分
已滿足適用檢查項的 85%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通必需25 分
- 已宣告認證方式必需10 分
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
