Get details on the current user

Get a list of all categories associated with the user's account. Returns categories in alphabetical order.

Get details on a single category or category group, including the list of children categories for category groups.

Create a new category or a category group. Set is_group=true to create a category group; supply children as an array of existing category IDs and/or strings (names of new sub-categories to create).

Update properties for an existing category or category group. For category groups, supplying children replaces the group's full child list. Cannot be used to convert between category and category group.

Delete a single category or category group. By default fails (HTTP 422) if dependencies exist, returning a structured dependents payload. Set force=true to delete and disassociate from all related budgets, transactions, recurring items, etc. Force delete is irreversible.

Get a list of all tags associated with the user's account.

Get details of a single tag by ID.

Create a new tag.

Update properties for an existing tag.

Delete a tag. By default fails (HTTP 422) with a structured dependents payload if the tag is in use by transactions or rules. Set force=true to delete and disassociate from those records.

Retrieve transactions, optionally filtered by date range, account, category, tag, recurring item, status, and more. Returns at most limit transactions (default 1000, max 2000); has_more is set on the response when more match the filters. Pending and split-parent / group-child transactions are excluded by default.

Get details of a specific transaction. The response always includes plaid_metadata, custom_metadata, files, and (for split or group parents) the children array — none of which are returned by default in get_transactions.

Insert one or more transactions (1-500 per call). Returns inserted transactions plus any skipped duplicates.

Update an existing transaction. Provide any subset of writable fields directly (the v2 API no longer wraps the body in a transaction envelope). Cannot modify split or grouped transactions; use the corresponding split/group tools instead.

Delete a single transaction. Fails for split/group transactions and their parents — unsplit/ungroup first. Irreversible.

Update multiple transactions in a single call (1-500). Each entry must include id plus at least one writable field. Cannot be used to modify split or grouped transactions.

Bulk-delete transactions by ID (1-500). Fails if any ID is a split or group parent, or part of a split/group; unsplit or ungroup those first. Irreversible.

Create a transaction group from 2-500 existing transactions. Source transactions are hidden from get_transactions and accessible via the new group's children (set include_children=true on get_single_transaction). Cannot include split or recurring transactions.

Delete (ungroup) a transaction group. The original child transactions remain and revert to normal ungrouped transactions.

Split an existing transaction into 2-500 child transactions. The sum of child amounts must equal the parent's amount. After splitting, the parent is hidden from get_transactions and accessible via get_single_transaction (returns the parent with children).

Unsplit a previously split transaction by deleting its children and restoring the parent. Pass the parent (split_parent_id) — not a child — as the path id.

Attach a local file (max 10MB) to a transaction. Allowed types: image/jpeg, image/png, image/heic, image/heif, application/pdf. The file is read from the local filesystem of the host running this MCP server.

Get a short-lived signed download URL for a transaction file attachment. The response includes the URL and an expires_at timestamp.

Delete a transaction file attachment. Irreversible.

Retrieve a list of recurring items expected for a specified date range. The matches object on each item is populated based on the requested range.

Retrieve a single recurring item by ID. Optional date range populates the matches object.

Get a summary of the user's budget for a specified date range. Returns per-category totals (other_activity, recurring_activity, budgeted, available, recurring_remaining, recurring_expected). Set include_occurrences=true for a per-period breakdown matching the account's budget periodicity. (Backed by the v2 GET /summary endpoint.)

Get budget period and display settings for the account (granularity, period length, anchor date, hide-no-activity preference, income option, rollover-left-to-budget setting).

Create or update a budget for a category and budget period. The start_date must be a valid budget period start for the account (see get_budget_settings).

Remove the budget for a specific category and period. The request is idempotent — succeeds even if no budget exists for the period.

Get a list of all manually-managed accounts associated with the user. (Formerly known as assets in the v1 API.)

Get details of a single manual account by ID.

Create a new manually-managed account. (Formerly create_asset.)

Update an existing manually-managed account. (Formerly update_asset.)

Delete a manually-managed account. Optionally also delete its transactions/rules/recurring items, and/or its balance history. Both deletion options are irreversible.

Get a list of all Plaid (synced) accounts associated with the user.

Get details of a single Plaid (synced) account by ID.

Trigger a fetch of latest data from Plaid. Optionally scope the fetch to a date range and/or a specific Plaid account ID. Note: Plaid enforces a minimum 60-second delay between fetch requests; fetching may take up to 5 minutes.

Get all cryptocurrency holdings from the v1 crypto endpoint. Returns both synced and manually managed crypto assets.

Update a manually-managed crypto asset via the v1 crypto endpoint. The id must be from a get_all_crypto result with source=manual.