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.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://envelopebudget.com/mcp'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

EnvelopeBudget MCP

Official Model Context Protocol server for EnvelopeBudget, read-only by default with an optional categorization-only write scope.

MCP Registry Transport Access

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

ToolPurpose
list_budgetsDiscover budgets available to the API-key owner
get_budget_overviewRead available-to-budget, account totals, and envelope totals
list_accountsList safe account fields and balances
list_envelopesList envelope balances and monthly targets
search_transactionsSearch a bounded page of transactions; memo text is opt-in
get_transactionRead one transaction within an authorized budget
get_spending_summaryGroup spending over a bounded date range
get_cashflow_summarySummarize inflow, outflow, and net cashflow
get_ai_categorization_disclosureExplain the current AI data-sharing disclosure
list_ai_categorization_jobsList existing owner-visible categorization jobs
get_ai_categorization_reviewReview existing suggestions without applying them
start_ai_categorizationStart the existing suggestion workflow with an explicitly scoped key and prior human consent
resolve_ai_categorization_suggestionsApprove or reject up to 50 selected pending suggestions with an explicitly scoped key
assign_transaction_envelopesAssign 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

  1. Sign in to EnvelopeBudget.
  2. Open Developer API Keys.
  3. 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.
  4. Configure your MCP client using Client setup.
  5. 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.json and mcp.json. Cursor prompts for ENVELOPEBUDGET_API_KEY through the plugin variable schema; no credential is committed with the package.
  • Glama: glama.json supplies 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

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.