Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Banktivity

by david00769version 1.0.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.david00769/banktivity-swift-mcp

How to install

What it does

Banktivity MCP server for .bank8 vaults; writes go through Core Data so CloudKit sync sees them.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 2/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try it

    Use Banktivity and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Banktivity or shows a Banktivity tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Banktivity yet

Banktivity runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Banktivity

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect Banktivity yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Banktivity

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Cursor cannot connect Banktivity yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Banktivity

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

VS Code cannot connect Banktivity yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect Banktivity

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Banktivity💬 Discussion →
For developers: Terminal commands and JSON settings

Values you fill in

  • BANKTIVITY_FILE_PATH env
    Path to your .bank8 vault; if unset, the single Banktivity 10 vault is used
  • BANKTIVITY_STORE_READ_ONLY env
    Set to 1 to open the vault read-only

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
No licence stated
Connection
Runs on your computer
Latest versioni
1.0.0
Categoryi
Other
Published to registryi
Nov 16, 2026
Code last changedi
Nov 16, 2026
Maker
david00769
Packages
mcpb: …/banktivity-swift-mcp-v1.0.0-macos-universal.mcpb
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account david00769, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 3 days ago

  • ! Caution

    Has a licence

    GitHub could not identify the licence type; open the file to check

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/david00769-banktivity-swift-mcp.svg)](https://mcp.popnx.com/en/servers/david00769-banktivity-swift-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 0% of the other 20653 servers in this category
  • Published to the registry more recently than 92% of the other 20653 servers in this category
  • Basic checks equal to or better than 46% of the other 20653 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Banktivity safe?

It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 3 days ago, and the latest version (1.0.0) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 3 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 30 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
Banktivity
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks2/34/44/44/41/44/4
LicenseNOASSERTIONAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

banktivity-swift-mcp: Banktivity MCP server and CLI for AI assistants

A Swift library, Model Context Protocol (MCP) server and command-line tool for Banktivity personal finance files. It lets Claude Desktop, Claude Code, Cursor and other MCP clients or AI agents read and write a Banktivity 10 .bank8 vault: accounts, transactions, splits, categories, payees, tags, templates, import rules, scheduled transactions, statements and securities. It can also export a vault as RDF.

  • banktivity-cli is the command-line tool, for scripts, for AI agents that run shell commands, and for looking things up yourself.
  • banktivity-mcp is an MCP server with 80 tools, so an AI assistant such as Claude can work with your vault.
  • BanktivityLib is the library both are built on. It has no server dependencies.

Every change goes through Core Data, the way Banktivity itself writes, so edits are seen by Banktivity's iCloud/CloudKit sync. See CloudKit sync safety.

CloudKit sync safety: why Core Data, not direct SQLite

A .bank8 vault is a Core Data store, and Banktivity syncs it through CloudKit.

  • Writing SQLite directly is invisible to sync. A tool that writes core.sql with SQL bypasses Core Data's change tracking. CloudKit sync never sees those edits, so they can fail to sync, be reverted, or corrupt the vault. Martijn Riemers's TypeScript banktivity-mcp, which inspired the Swift rewrite, was built that way.
  • This tool writes through Core Data. Steve Flinter's Swift rewrite opens the vault with NSPersistentContainer, using Banktivity's own compiled data model, and makes every change through it, as Banktivity does.
  • Writes are refused while Banktivity has the vault open (an lsof check, from the Swift rewrite).
  • This fork adds more guards. CLI edits are no longer reverted by the next sync, Core Data is never allowed to migrate (rewrite) Banktivity's database, and the write guard now refuses when it cannot tell and is enforced where every write is saved. See Safety Features.

Warning: this tool changes your Banktivity data. Write commands make real

changes to your vault, and AI assistants make mistakes. Back up the vault before

any write session, and work on a copy until you trust your setup. The authors

are not responsible for data loss.

Using it safely

  • Run one banktivity-cli or banktivity-mcp process per vault at a time. Writes are queued inside one process, but nothing locks the file across processes.
  • Quit any banktivity-mcp server before you open the same vault in Banktivity.app. The app and this tool must not have the file open together. (Writes are refused while Banktivity has the vault open, but reads are not.)
  • Back up before every write session.
  • After restoring, importing or migrating a vault in Banktivity 10, look up account, transaction, statement and category IDs again. Banktivity can renumber them.

About this fork

This is david00769's maintained fork of Steve Flinter's banktivity-swift-mcp. It has everything upstream has. Upstream merged nine of this fork's pull requests on 2026-11-03, so much of the fork's earlier work is in upstream too. Some of what is listed below is still offered upstream as pull requests; the rest is only here.

What the fork adds:

  • Edits that survive sync. Changes made with the CLI are no longer reverted the next time Banktivity syncs.
  • Statements: reconciliation that selects the same rows the Banktivity app does, plus repair commands for statement rows.
  • Investments: create security trades and income, and see realised capital gains per lot.
  • Safety and reporting: a machine-readable list of which commands write, net worth in one reporting currency, and an investment account's holdings value on its balance.
  • New in v0.17.0:
  • a guard that stops Core Data from rewriting Banktivity's database;
  • accounts update;
  • line-items source, showing the raw bank import behind a transaction;
  • automatic transaction types on create;
  • an optional HTTP server mode.

Some of this came from other people's forks. ACKNOWLEDGEMENTS.md credits each contribution, and CHANGELOG.md lists every change by release.

Which Banktivity MCP should I use?

Three related projects come up when you search for a Banktivity MCP server:

ProjectLanguageHow it writesInstallStatus
mhriemers/banktivity-mcpTypeScript (npm)SQL into core.sql (as described when the Swift rewrite began)npmThe original TypeScript server that inspired the Swift rewrite
sflinter/banktivity-swift-mcpSwiftCore Data (NSPersistentContainer)Homebrew (sflinter/tap)The Swift rewrite this fork is based on
david00769/banktivity-swift-mcp (this repo)SwiftCore Data, plus the guards aboveRelease download or make installMaintained; everything upstream has, plus the fork's additions

If you want an AI assistant to write to a vault that syncs through iCloud, use one of the Core Data projects. All three can read a vault.

Requirements

  • macOS 14 or later
  • A Banktivity .bank8 vault

Installation

Download a release (recommended)

Each release has one universal download (Apple Silicon and Intel) and a checksum file. CI builds and tests the release from the tagged commit. For v0.17.4:

base=https://github.com/david00769/banktivity-swift-mcp/releases/download/v0.17.4

curl -LO "$base/banktivity-swift-mcp-v0.17.4-macos-universal.tar.gz" curl -LO "$base/banktivity-swift-mcp-v0.17.4-macos-universal.tar.gz.sha256" shasum -a 256 -c banktivity-swift-mcp-v0.17.4-macos-universal.tar.gz.sha256 # prints "OK"

tar xzf banktivity-swift-mcp-v0.17.4-macos-universal.tar.gz xattr -d com.apple.quarantine banktivity-cli banktivity-mcp 2>/dev/null || true mkdir -p ~/.local/bin && mv banktivity-cli banktivity-mcp ~/.local/bin/ banktivity-cli --version # 0.17.4

The binaries are signed ad hoc, not notarized. The xattr line removes the quarantine flag macOS puts on downloaded files, which would otherwise stop them from running.

Claude Desktop extension (.mcpb)

Each release also has banktivity-swift-mcp-vX.Y.Z-macos-universal.mcpb, an MCP Bundle. Download it and open it with Claude Desktop to install banktivity-mcp as an extension. Leave Vault path blank to use your Banktivity 10 vault (see Where is my vault?), and consider turning Read-only on. The binary inside is ad-hoc signed, not notarized; if macOS refuses to run it, clear the quarantine flag with xattr -dr com.apple.quarantine ~/Library/Application\ Support/Claude/Claude\ Extensions and restart Claude Desktop. It installs only the MCP server; for the CLI, use the download above. The server is also listed in the MCP Registry as io.github.david00769/banktivity-swift-mcp.

Build from source

Xcode 16 or later is recommended. Without Xcode the Makefile falls back to the Command Line Tools for building and installing (not tested here); running the tests needs Xcode.

git clone https://github.com/david00769/banktivity-swift-mcp.git

cd banktivity-swift-mcp make install # universal build, installed to ~/.local/bin

Always install with make install (or make install-fast for a quicker single-architecture build). Never copy a new binary over ~/.local/bin with cp. cp rewrites the file in place, and a banktivity-mcp still running from it is killed by macOS the next time it starts ("Code Signature Invalid"). The Makefile copies to a temporary name, signs it, then renames it into place.

Other Makefile targets:

make help           # list all targets

make install-fast # native-architecture build and install, for development make verify # check that the installed binaries actually run make build # debug build make test # run all tests make test-filter FILTER=AccountUpdateTests # run one test type make release # universal release build (arm64 + x86_64) make package # release tarball plus its SHA-256 make mcpb # the tarball plus the Claude Desktop bundle (.mcpb) make clean # remove build output

make test runs the suite the way a release build behaves: release configuration, one worker, Xcode's test frameworks.

Homebrew (upstream's version)
brew install sflinter/tap/banktivity-swift-mcp

This installs upstream's binaries, without this fork's changes.

How releases are made

CI (.github/workflows/ci.yml) runs on every push and pull request to main. It runs make test, then make package, so a change that breaks the release build fails before anyone tags it. To release, bump Sources/BanktivityLib/Version.swift and add a matching section to CHANGELOG.md, then push a tag:

git tag -a v0.18.0 -m "v0.18.0" && git push origin v0.18.0

.github/workflows/release.yml then checks that the tag matches Version.swift, runs the tests, builds the tarball and publishes the release. The CHANGELOG section becomes the release notes.

Configuration

Where is my vault?

Banktivity 10 keeps a vault that syncs through Banktivity Cloud in its own library, not in Documents:

~/Library/Group Containers/group.com.iggsoftware.banktivity.library/IGGFinance/production/Documents/<vault id>/1.bank8

The folder differs from Mac to Mac. If `BANKTIVITY_FILE_PATH` is unset or empty, `banktivity-mcp` and `banktivity-cli` use the vault in that folder, provided there is exactly one. With several they list them and stop, so you can pick one.

macOS asks permission first. That folder belongs to Banktivity, and macOS protects one app's data from other apps, so the first run is blocked until you grant access. See Granting access on macOS.

A vault saved anywhere else (the examples below use ~/Documents/Banktivity/My Accounts.bank8) needs its path set. The path must end in .bank8; if you give a folder, the error lists the vaults inside it.

Granting access on macOS

macOS blocks other programs from reading Banktivity 10's library until you allow it. Until then the server logs:

Error: macOS blocked access to Banktivity's library (…/IGGFinance/production/Documents). …

and Claude Desktop shows the extension as failed. You may also get a macOS notification about a program accessing "data from other apps". To fix it:

  1. Quit Banktivity.
  2. Open **System Settings > Privacy & Security > Full Disk

Only the beginning is shown; read the rest in the repo