Genie Expense Tracker

io.github.osamaadam由 GitHub 帳號 osamaadam 發布v1.1.0更新於 Oct 25, 2026

Read-only access to Genie accounts, transactions, investments, and financial summaries.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

一個遠端唯讀 MCP 伺服器，經 OAuth 授權後讓助理查看 Genie 的帳戶餘額、交易、投資、訂閱與淨資產。

可以做什麼
用 list_accounts 列出帳戶與卡片餘額，用 get_net_worth 取得淨資產快照，含幣別、估值與完整性欄位。搜尋、檢視並彙總交易。在已啟用投資時檢視投資持倉及其供應商或帳戶背景。彙總訂閱與分期付款。僅在另外授予 sms:read 權限時搜尋與讀取已儲存的財務簡訊。
適用情境
適合讓助理回答關於自己 Genie 財務的問題，例如餘額、支出、淨資產或持倉，同時不賦予它轉帳或修改紀錄的能力。
執行需求
遠端 Streamable HTTP 端點，不需本機套件或執行環境。需要 Genie 帳戶並完成 OAuth 授權流程，帳戶號碼只能在授權頁面輸入。讀取簡訊需選用的 sms:read 權限。需能連線至該託管端點。
安裝前請注意
存取為唯讀：連接器不能建立、變更、刪除或支付任何內容。它會暴露敏感財務資料，選用的 sms:read 權限會回傳完整的已儲存財務簡訊，僅在確有需要時授予。帳戶號碼只能在授權頁面輸入，切勿貼到對話、設定、問題或支援訊息中。淨資產與持倉僅為快照，不是報酬或績效追蹤。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Genie Expense Tracker，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.osamaadam%2Fgenie-expense-tracker/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "genie-expense-tracker": {
      "type": "http",
      "url": "https://genie-mobile.duckdns.org/mcp"
    }
  }
}

README

Genie Expense Tracker plugin

Connect Claude, and compatible ChatGPT/Codex marketplace clients where they support Agent Plugins 1.0, to Genie's private read-only remote MCP server. The package includes the shared Agent Plugins manifest, Claude marketplace metadata, the Genie finance skill, and a Streamable HTTP MCP configuration.

What Genie can provide

After you authorize the connection, Genie can provide read-only:

  • Account and card balances with list_accounts.
  • Transaction search, detail, and aggregation.
  • A net-worth snapshot with get_net_worth, including primary currency, valued accounts, excluded accounts, unvalued items, completeness, and valuation dates.
  • Investment positions and provider/account context with list_investment_holdings when investments are enabled and discoverable.
  • Subscription and installment summaries.
  • Stored financial SMS search and detail only with the separately authorized sms:read permission.

The connector cannot create, change, delete, or pay anything. Net worth and holdings are snapshots, not returns or performance tracking. When a response is partial, follow its is_complete, inclusion/exclusion, valuation, and FX-date fields; never add list_accounts balances to reconstruct net worth.

Install from this repository

In Claude or Claude Desktop, open Customize → Plugins, select + → Add marketplace, and enter:

text
https://github.com/osamaadam/genie-claude-plugin

Install Genie Expense Tracker, enable it, and complete the Genie authorization flow when prompted. The same repository contains an Agent Plugins 1.0 package for compatible ChatGPT/Codex marketplace clients where that package format is supported; client and workspace availability can differ.

Install for development

Clone this repository, then run Claude Code from its parent directory:

sh
claude --plugin-dir ./genie-claude-plugin

Open /mcp in Claude Code and complete OAuth for the genie server. You can also validate the Claude package with:

sh
claude plugin validate ./genie-claude-plugin --strict

Connect without the plugin

The same server is available directly over Streamable HTTP:

sh
claude mcp add --transport http genie https://genie-mobile.duckdns.org/mcp

In Claude on the web or Claude Desktop, open Customize → Connectors → Add custom connector and enter:

text
https://genie-mobile.duckdns.org/mcp

Authentication and privacy

Genie uses OAuth. Enter your Genie account number only on the authorization page hosted at https://genie-mobile.duckdns.org; never paste it into Claude, a plugin configuration, an issue, or a support message.

The optional sms:read permission allows the connector to return complete stored financial SMS messages. Grant it only if you want Claude to inspect those messages.

Security reports

Report vulnerabilities privately to [email protected]. Do not open a public issue containing account numbers, tokens, authorization codes, financial records, or SMS messages.

License

The plugin metadata and skill instructions in this repository are available under the MIT License. The license does not apply to the separate Genie application or backend service.

來源：README.md，提交 92dffde

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v1.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分