npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

tiedout

v0.1.1

Published

Match bank statements to invoices from local CSV files. MCP server and CLI; your data stays on your machine.

Readme

tiedout: bank reconciliation for CSV files

npm CI MIT license MCP Registry

Match your bank statement to your invoices or bills, with exact math and without uploading your books anywhere. For small businesses, freelancers and bookkeepers.

Reconciling payments by hand is slow, and asking an AI model to compare long CSV files invites arithmetic mistakes. tiedout does the matching in code and sorts every line into matched, likely, review or unmatched, with the reason. A person or an agent only has to look at the exceptions. It's an MCP server and a CLI with no account, no API key and no network access.

It works with any bank or invoicing tool that exports CSV. It reads title lines, footers, separate credit and debit columns, semicolons, decimal commas, day-first dates and several languages' column names.

What you can ask your agent

  • "Here's my bank export and my invoices. Who has paid?"
  • "Which customers still owe me money?"
  • "Match these supplier bills to my bank statement."
  • "Are there any duplicate payments, or payments with no invoice?"

Install

As a Claude Code plugin, which adds the MCP server and a skill that tells Claude when to use it:

claude plugin marketplace add GillMacedo/tiedout
claude plugin install tiedout@tiedout-marketplace

For other MCP clients, run it from npm. You need Node 22.19 or newer:

{
  "mcpServers": {
    "tiedout": {
      "command": "npx",
      "args": ["-y", "tiedout", "serve"]
    }
  }
}

Usage

Try it on the sample files in examples/. All the names in them are made up.

$ node plugin/dist/tiedout.js match examples/bank.csv examples/invoices.csv
MATCHED (2)
  2026-03-02  1200.00  TRANSFER FROM EXAMPLE SUPPLIES REF INV-1001  -> INV-1001  [invoice number and amount]
  2026-03-04  450.50  PAYMENT FICTIONAL CAFE INV 1002 INV1003  -> INV-1002, INV-1003  [invoice numbers and total]
LIKELY: check these (2)
  2026-03-09  975.00  SAMPLE WIDGETS ONLINE TRANSFER  -> INV-1004  [amount and party name]
  2026-03-16  700.00  PLACEHOLDER GARDENS  -> INV-1007, INV-1008  [party name, and the amounts add up]
REVIEW: a person should decide (3)
  2026-03-11  590.00  ACME TEST CO INV-1005  -> INV-1005  [names INV-1005, but short by 10.00]
  2026-03-18  1200.00  TRANSFER FROM EXAMPLE SUPPLIES REF INV-1001  [names INV-1001, which is already settled: possible duplicate payment]
  2026-03-12  310.00  DEPOSIT 3301  -> INV-1006  [amount only]
UNMATCHED BANK LINES (1)
  2026-03-20  42.00  UNKNOWN SENDER
OPEN INVOICES (1)
  INV-1009  125.00  Mock Logistics  due 2026-03-28
SKIPPED bank row 12: no valid date
2 matched, 2 likely, 3 to review, 1 unmatched, 1 open invoices

Use --payable to match money out to bills. Run tiedout with no arguments to see all options, including --json and naming columns by hand.

How it decides

| Group | Rule | |---|---| | Matched | The bank line names the invoices, and the amounts agree exactly | | Likely | The party name appears and the amount fits only one option, or a set of that party's invoices adds up in only one way | | Review | A named invoice with the wrong amount, a possible duplicate, a tie, or an amount with nothing else to support it |

It never breaks a tie, and it never reports a row as gone without saying why.

MCP tools

| Tool | What it does | |---|---| | reconcile_match | Matches two CSV files and returns the groups, with a limit for large results | | reconcile_inspect_csv | Shows detected columns and row counts, without row contents |

Both are read-only. reconcile_match returns names and amounts from your files to the MCP client, so they reach whichever AI model you use. The tiedout CLI keeps everything on your machine.

Limits

  • This helps with bookkeeping and isn't accounting advice. Check results before relying on them.
  • It reads CSV only, so PDF statements need converting first.
  • It assumes two decimal places and doesn't convert currencies. Lines in different currencies never match.
  • It treats each file as the full list of open items. It doesn't track partial payments across runs.
  • So far it has been tested on made-up data in common export formats, not on every bank's real exports. If yours fails, please open an issue with the column headers, not your data.

FAQ

How do I reconcile a bank statement with invoices automatically? Export both as CSV and run npx tiedout match bank.csv invoices.csv. Matches come out with the reason, and anything uncertain goes to review.

Is my financial data uploaded? The tool has no network code. The CLI keeps everything on your machine. Through MCP, results go to whichever AI model your client uses.

Does it work with QuickBooks, Xero or my bank? It reads CSV exports rather than connecting to them. Most accounting tools and banks can export CSV. It hasn't been tested on each one's real exports yet.

Can it match accounts payable? Yes. Use --payable to match money out to bills.

Contributing

Contributions are welcome, from people and from people working with AI agents. See CONTRIBUTING.md. Good first issues:

  • Add column names for more languages and accounting tools
  • Add --out to write results to a CSV for a spreadsheet
  • Support OFX and QIF bank files
  • Track partial payments across several bank lines
  • Add a plugin icon

AI disclosure

This project was largely generated with Claude Code and reviewed by its maintainer.

About me

I'm Giulliano Macedo, and I build developer tools at GoTech Solutions. Follow along or get in touch:

If tiedout saved you an afternoon, a star helps others find it.


MIT licensed.

Built by Giulliano Macedo, GoTech Solutions · LinkedIn · X