Skip to main content
Glama
PocketQuota

PocketQuota

by ReHowever

v0.3.1 · 双环与双光轨同时显示今日额度和日常池总余额,配合蓄水池、保险柜与共享账本。更新详情


今天,还能自由花多少?

PocketQuota 把这个问题变成一条看得见的额度。

给日常消费设定限额,把节省下来的钱存进灵活池;需要多一点空间时,自动从灵活池补足。你可以随手在网页记一笔,也可以直接告诉自己的 Agent——两边始终共用同一本账。

日常有边界,灵活有余地。

Related MCP server: agent-budget

一个额度面板,掌握消费节奏

看见额度

让规则运转

和 Agent 协作

今日剩余、资金池余额、消费趋势一眼可见

每日结余自动划转,补贴与生活费按时入账

对话记账、查询预算、核对账目、接收额度提醒

黑白主题,线形光轨与圆环自由切换

补记、撤销、余额调整都有完整记录

网页账号与 Agent 共享同一份预算和通知

额度随消费变化:扣款时粒子轻轻消散,入账时光带汇入。三套光谱配色,搭配清爽的黑白界面,把每天看预算变成一件舒服的事。

把钱分好,把选择留给自己

资金池

为你做什么

日常池

每天的默认消费来源,用每日限额把握节奏

灵活池

接住每日结余,承接超额消费,也可直接指定使用

保底池

单独留存的一份安心,由你明确安排用途

例如:每天额度 ¥60,今天已经花了 ¥50,再记一笔 ¥25。PocketQuota 会自动分配 日常 ¥10 + 灵活 ¥15,清楚展示每一分钱的去向。

月底回顾、每日核对、临时调整,都可以在同一个地方完成。CSV 导出支持日期筛选、中文列名和各资金池实际扣款额,方便继续用 Excel 整理。

当可消费预算耗尽,界面会切换为醒目的红色 “赤字 · 已破产” 状态,并生成供通知 Agent 领取的额度事件。提醒流程见 Agent 通知指南。

一句话记账,剩下交给规则

“午饭花了 18.5,记日常池。”
“这次旅行的车费 35,走灵活池。”
“今天还剩多少额度?”
“把每日限额改成 60,明天开始。”
“每月 1 号上午 9 点,给日常池记入 1800 生活费。”

给你的 Agent 一枚本账号的专用令牌,就能让对话与网页保持同步。按需要选择 只读、记账、预算管理 三档权限。

你正在使用的工具

接入方式

Codex

MCP 配置

Claude Code / Desktop、Cursor

MCP 配置

VS Code Copilot、Gemini CLI

VS Code 配置 · Gemini 配置

Hermes 与其他 MCP Agent

标准 MCP stdio 接入

DeepSeek / OpenAI-compatible 与自建 Agent

Function-calling 适配器 · REST / OpenAPI

13 个 MCP 工具,一套统一账本接口。 配置步骤、工具权限与客户端验证情况集中在 Agent 接入文档。

开始体验

准备 Python 3.11+,运行三行命令:

git clone https://github.com/ReHowever/pocketquota.git
cd pocketquota
python3 -m pocketquota.server --demo --data .demo-data

打开 本机演示,点击 “试用演示账本”,即可探索完整界面与虚构示例。

准备开始自己的预算时,使用 正式部署指南。支持直接运行、Python 安装包与 Docker。

自己掌握数据,也掌握规则

  • 独立账号:每个用户拥有自己的账本,Agent 绑定同一账号。

  • 随机初始密码:默认管理员与新建用户均使用随机强密码。

  • 可追溯账本:金额精确到分,自动结算、补记和撤销都有记录。

  • 按你的节奏:日限、生效日、结算时间、月对账日期和定期入账都可配置。

  • 开源可扩展:MIT 许可,标准接口,适合个人使用和继续构建自己的工具。

继续探索

使用指南 · 部署与备份 · Agent 接入 · API · 设计说明 · 安全说明 · 发布验收

欢迎分享使用体验、提出功能建议,或通过 Issue 与 Pull Request 一起完善 PocketQuota。


Available Tools

13 tools
budget_ack_notificationA
Idempotent

Acknowledge an event only AFTER successful owner notification. Failed delivery must remain pending. Use one designated notification agent per ledger.

Inputs: id (required), request_id (required).

budget_adjust_poolA
Idempotent

Requires manage scope and explicit user request. Set a pool's actual budget balance with an audit reason; this creates an adjustment entry, not a bank transfer.

Inputs: pool (required), reason (required), balance (required), request_id (required).

budget_configureA
Idempotent

Requires manage scope and explicit user request. Change daily allowance or settlement/review times. Fetch budget_status first for settings.revision; effective date cannot be in the past.

Inputs: revision (required), request_id (required), name, effective, +5 more.

budget_notificationsA
Read-only

List unacknowledged budget-exhausted notifications. Only notify the ledger owner through an authorized channel. Empty list means remain silent. Use event ID to deduplicate delivery.

Inputs: no named parameters.

budget_reconcileB
Idempotent

Record a user's explicitly supplied real balances. Never fabricate actual balances from expected values. Does not automatically adjust the ledger.

Inputs: actual (required), period (required), request_id (required), note.

budget_recordB
Idempotent

Record user-authorized expense, income or transfer. Default pool daily. Excess daily quota or exhausted daily pool is immediately covered by flex. Reuse request_id when retrying this same user request.

Inputs: amount (required), request_id (required), date, kind, +4 more.

budget_reverseB
Idempotent

Reverse an incorrect manual transaction, preserving audit. Only on user authorization; do not silently delete or hide history.

Inputs: id (required), reason (required), request_id (required).

budget_scheduleA
Idempotent

Requires manage scope and explicit user request. Create/edit/pause a daily or monthly credit schedule. Only accounting, not a payment. Existing schedule IDs come from budget_schedules.

Inputs: amount (required), request_id (required), id, day, +5 more.

budget_schedulesB
Read-only

List recurring credit schedules and their IDs.

Inputs: no named parameters.

budget_settleA
Idempotent

Requires manage scope. Explicitly settle a day early; automatic settlement already runs on the server. Safe to retry with the same request_id.

Inputs: request_id (required), date.

budget_statusA
Read-only

Read today's quota, pool balances, overspend and insolvency status. Money returned in integer cents.

Inputs: no named parameters.

budget_summaryA
Read-only

Read expected pool balances and settlements for a day YYYY-MM-DD or completed month YYYY-MM.

Inputs: period (required).

budget_transactionsC
Read-only

Read dated journal entries, including reversals and automatic allocations.

Inputs: end, start, offset.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 13 tools

    Disambiguation4/5

    Most tools target clearly distinct actions or resources, with readable boundaries between recording, reversing, settling, scheduling, and notification handling. Minor potential confusion exists between budget_status and budget_summary, and between budget_adjust_pool and budget_reconcile, though descriptions clarify the different effects.

    Naming Consistency4/5

    All tools use a consistent budget_ prefix and snake_case. Suffixes mix nouns and verbs (budget_status, budget_record, budget_schedules, budget_ack_notification), which is readable but not a strict verb_noun pattern.

    Tool Count5/5

    The 13 tools are well within a manageable range and each appears to serve a distinct budget/quota workflow. The set is neither thin nor bloated for a ledger-style server.

    Completeness4/5

    Core workflows are covered: status, transaction recording/reversal, summaries, reconciliation, scheduling, settlement, and notification acknowledgement. Minor gaps may exist around explicit pool lifecycle management and detailed single-record retrieval, but agents can work around them via existing list and adjustment tools.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Budget management and cost tracking MCP server for autonomous agents, enabling budget creation, cost recording, spending projections, and alert rules.
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables agents to track real-time token spend and cost velocity, automatically throttle or freeze execution when budgets are exceeded, and enforce sandbox and safety guardrails.
      MIT