MCPcopy
hub / github.com/actualbudget/actual

github.com/actualbudget/actual @v26.7.0 sqlite

repository ↗ · DeepWiki ↗ · release v26.7.0 ↗
5,683 symbols 22,246 edges 1,857 files 127 documented · 2%
README

Actualbudget

Getting Started

Actual is a local-first personal finance tool. It is 100% free and open-source, written in NodeJS, it has a synchronization element so that all your changes can move between devices without any heavy lifting.

If you are interested in contributing, or want to know how development works, see our contributing document we would love to have you.

Want to say thanks? Click the ⭐ at the top of the page.

Key Links

Installation

There are four ways to deploy Actual:

  1. One-click deployment via PikaPods (~1.40 $/month) - recommended for non-technical users
  2. Managed hosting via Fly.io (~1.50 $/month)
  3. Self-hosted by using a Docker image
  4. Local-only apps - downloadable Windows, Mac and Linux apps you can run on your device

Learn more in the installation instructions docs.

Ready to Start Budgeting?

Read about Envelope budgeting to know more about the idea behind Actual Budget.

Are you new to budgeting or want to start fresh?

Check out the community's Starting Fresh guide so you can quickly get up and running!

Are you migrating from other budgeting apps?

Check out the community's Migration guide to start jumping on the Actual Budget train!

Documentation

We have a wide range of documentation on how to use Actual, this is all available in our Community Documentation, this includes topics on Budgeting, Account Management, Tips & Tricks and some documentation for developers.

Contributing

Actual is a community driven product. Learn more about contributing to Actual.

Code structure

The Actual app is split up into a few packages:

  • loot-core - The core application that runs on any platform
  • desktop-client - The desktop UI
  • desktop-electron - The desktop app

More information on the project structure is available in our community documentation.

Feature Requests

Current feature requests can be seen here. Vote for your favorite requests by reacting :+1: to the top comment of the request.

To add new feature requests, open a new Issue of the "Feature Request" type.

Translation

Make Actual Budget accessible to more people by helping with the Internationalization of Actual. We are using a crowd sourcing tool to manage the translations, see our Weblate Project. Weblate proudly supports open-source software projects through their Libre plan.

Translation status

Repo Activity

Alt

Sponsors

Thanks to our wonderful sponsors who make Actual Budget possible!

Deploys by Netlify Built with Depot Docker GitHub Anthropic

Extension points exported contracts — how you extend this code

Matchers (Interface)
(no doc)
packages/desktop-client/globals.ts
Window (Interface)
(no doc)
packages/api/e2e/browser.test.ts
Window (Interface)
(no doc)
packages/loot-core/typings/window.ts
Window (Interface)
(no doc)
packages/desktop-client/src/index.tsx
Process (Interface)
(no doc)
packages/loot-core/typings/process-worker.ts

Core symbols most depended-on inside this repo

expect
called by 4377
packages/loot-core/src/shared/test-helpers.ts
get
called by 563
packages/sync-server/src/services/secrets-service.js
filter
called by 519
packages/api/app/query.js
dispatch
called by 508
packages/desktop-client/src/components/modals/BudgetAutomationsModal/AutomationEditorPane.tsx
find
called by 434
packages/sync-server/src/app-sync/services/files-service.ts
send
called by 422
packages/desktop-client/src/mocks/connection.ts
send
called by 344
packages/crdt/src/crdt/timestamp.ts
filter
called by 327
packages/loot-core/src/shared/query.ts

Shape

Function 4,938
Method 542
Class 196
Interface 5
Enum 2

Languages

TypeScript100%

Modules by API surface

packages/loot-core/src/server/db/index.ts68 symbols
packages/api/methods.ts58 symbols
packages/loot-core/src/shared/months.ts54 symbols
packages/loot-core/src/server/spreadsheet/spreadsheet.ts45 symbols
packages/desktop-client/src/components/reports/spreadsheets/sankey-spreadsheet.ts45 symbols
packages/loot-core/src/server/accounts/app.ts43 symbols
packages/loot-core/src/server/aql/compiler.ts41 symbols
packages/desktop-client/src/components/rules/RuleEditor.tsx37 symbols
packages/crdt/src/crdt/timestamp.ts37 symbols
packages/sync-server/src/app-gocardless/errors.ts36 symbols
packages/loot-core/src/shared/util.ts36 symbols
packages/loot-core/src/server/transactions/transaction-rules.ts36 symbols

Dependencies from manifests, versioned

@actual-app/apiworkspace:* · 1×
@actual-app/ci-actionsworkspace:* · 1×
@actual-app/componentsworkspace:* · 1×
@actual-app/coreworkspace:* · 1×
@actual-app/crdtworkspace:* · 1×
@actual-app/sync-serverworkspace:* · 1×
@actual-app/vite-plugin-peggyworkspace:* · 1×
@actual-app/webworkspace:* · 1×
@babel/core7.29.7 · 1×
@bufbuild/protobuf2.12.0 · 1×
@bufbuild/protoc-gen-es2.12.0 · 1×

For agents

$ claude mcp add actual \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact