EnvelopeBudget
Official remote MCP server for EnvelopeBudget. Lets AI assistants review authorized envelope budgets, accounts, envelopes and transactions, read-only by default with optional categorization-only write scopes.
Servidor MCP alojado
npx add-mcp 'https://envelopebudget.com/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
EnvelopeBudget MCP
Official Model Context Protocol server for EnvelopeBudget, read-only by default with an optional categorization-only write scope.
EnvelopeBudget MCP lets compatible AI assistants answer questions about an authorized envelope budget. Every key is read-only by default; a person may explicitly create a dedicated key that can start the existing AI categorization workflow and resolve selected pending suggestions.
- Endpoint:
https://envelopebudget.com/mcp - Registry name:
com.envelopebudget/mcp - Version:
1.2.0 - Authentication: EnvelopeBudget developer API key as a Bearer token
- Transport: MCP Streamable HTTP
What it can do
| Tool | Purpose |
|---|---|
list_budgets | Discover budgets available to the API-key owner |
get_budget_overview | Read available-to-budget, account totals, and envelope totals |
list_accounts | List safe account fields and balances |
list_envelopes | List envelope balances and monthly targets |
search_transactions | Search a bounded page of transactions; memo text is opt-in |
get_transaction | Read one transaction within an authorized budget |
get_spending_summary | Group spending over a bounded date range |
get_cashflow_summary | Summarize inflow, outflow, and net cashflow |
get_ai_categorization_disclosure | Explain the current AI data-sharing disclosure |
list_ai_categorization_jobs | List existing owner-visible categorization jobs |
get_ai_categorization_review | Review existing suggestions without applying them |
start_ai_categorization | Start the existing suggestion workflow with an explicitly scoped key and prior human consent |
resolve_ai_categorization_suggestions | Approve or reject up to 50 selected pending suggestions with an explicitly scoped key |
assign_transaction_envelopes | Assign up to 50 observed inbox transactions to explicit envelopes with signed state tokens and a separately scoped key |
Safety boundary
Version 1.2 is read-only by default. Provider-suggestion decisions require ai-categorization:write; direct agent assignments require the separate transaction-categorization:write scope. Even a write-enabled key cannot:
- create or update transactions;
- move money between envelopes;
- record or change AI disclosure consent;
- assign transactions without a current signed state token or alter transaction fields;
- configure bank connections, imports, memberships, or billing.
Categorization writes are owner-only, bounded to 50 explicit decisions, API-key attributed, and undoable. Direct assignments require a short-lived signed token proving the transaction has not changed since the agent read it, plus an idempotency key; the batch is all-or-nothing. Every scoped tool requires an explicit budget ID and re-checks the caller's EnvelopeBudget membership and role. Searches and date ranges are bounded. Bank credentials, provider tokens, import identifiers, and integration metadata are never returned. Transaction memo text is omitted unless explicitly requested.
See Security and privacy.
Connect
- Sign in to EnvelopeBudget.
- Open Developer API Keys.
- Create a dedicated, expiring API key and copy it when shown. Leave both categorization permissions off for read-only access; enable only the narrow workflow that client needs.
- Configure your MCP client using Client setup.
- Delete or rotate the key to disconnect the client.
Never paste a key into a prompt, issue, screenshot, or committed file.
Distribution packages
- Cursor Plugin: this repository includes
.cursor-plugin/plugin.jsonandmcp.json. Cursor prompts forENVELOPEBUDGET_API_KEYthrough the plugin variable schema; no credential is committed with the package. - Glama:
glama.jsonsupplies display metadata and the complete 14-tool catalog for GitHub ingestion. - Hermes Agent: the reviewed catalog contribution is tracked in NousResearch/hermes-agent#93196.
Try these prompts
- “List my budgets, then summarize this month's available funds, spending, and cashflow for Household.”
- “Show uncategorized transactions from the last 14 days. Do not include memo text.”
- “Compare this month's spending by envelope with current envelope balances.”
- “Review the last 90 days of cashflow and suggest a monthly funding plan. Do not change anything.”
- “Explain the AI categorization disclosure and summarize existing suggestions. Do not start or approve anything.”
- “Review my pending AI categorization suggestions. Approve the high-confidence grocery and utility suggestions, reject the two I name, and leave all others unchanged.”
Documentation
- Client setup
- Tool reference
- Security and privacy
- Official Registry manifest
- Product setup page
- Changelog
Support
Use GitHub Issues for documentation, client configuration, and MCP interoperability problems. For account or financial-data support, contact EnvelopeBudget support.
This repository contains public documentation and examples. The hosted server implementation lives with the EnvelopeBudget application and is not published here.