Expefi

Budget MCP

Budget MCP by ExpeFi — Connect Your Budget to AI

Give an approved AI client read-only access to the category limits you configured in ExpeFi. Results identify the budget month, category, limit, and original currency without changing the plan.

Pre-registered clientsRead-onlyOAuth 2.1 with PKCEUser-revocable
Sign in to ExpeFi Manage AI connections

Monthly

period filter

100

budgets per page

Read-only

budget access

Data contract

Configured limits, without invented progress

The budget tool reports saved category limits. It does not claim spent, remaining, utilization, or overspending unless those values are present in a future completeness-aware contract.

Budget month

An optional YYYY-MM period narrows the returned budget records.

Category

A pseudonymous category reference is paired with the user-visible ExpeFi category name when known.

Limit and currency

Each saved limit stays in its original currency rather than being silently converted.

Pagination

Clients request up to 100 records and follow an opaque cursor for another page.

Bounded by design

  • The tool reads configured budget limits; it does not edit them.
  • Unknown custom category references remain unnamed rather than receiving a fabricated label.
  • Budget responses include asOf, partial, and missing metadata.
  • No transaction total is represented as budget progress by this tool.

Example response

Synthetic budget response. It illustrates the response shape and is not customer data.

{
  "asOf": "2026-08-24T09:00:00.000Z",
  "partial": false,
  "missing": [],
  "data": {
    "items": [{
      "period": "2026-08",
      "categoryName": "Groceries",
      "limit": 500,
      "currency": "USD"
    }],
    "nextCursor": null,
    "total": 1
  }
}

Authorize, use, revoke

An approved client starts OAuth authorization, you approve the requested read scopes, and ExpeFi binds every request to the authenticated token subject. D1 stores grant metadata and revocation state, never raw access or refresh tokens. Revoke access from Settings whenever you choose.

  1. 01Choose an approved MCP client and start its ExpeFi connection.
  2. 02Sign in through Clerk and review the requested read scopes.
  3. 03Use the granted tools within their pagination and response limits.
  4. 04Revoke the client from MCP / AI connections in ExpeFi Settings.

Frequently asked questions

Can the Budget MCP change a category limit?

No. The list_budgets tool can only read saved limits.

Does it calculate how much remains?

No. The current contract reports configured limits and does not invent spending, remaining, or utilization values.

Can I request one month?

Yes. The optional period filter accepts a month in YYYY-MM format.

Are category names included?

Known ExpeFi category IDs are returned with their user-visible names. An unknown category remains explicitly unnamed.

Related MCP pages

ExpeFi MCPBudget MCPSpending MCP