Convert a Bank CSV to QBO from ChatGPT or Claude
You can convert a bank CSV into a QuickBooks .QBO file directly from an AI assistant like Claude or ChatGPT, without leaving the chat. QBO Maker exposes the conversion as an MCP server and a hosted Convert API, so an agent can take your transactions and hand back a ready-to-import file. If you just want to convert a file yourself, the free browser tool still does that with nothing uploaded.
Two ways to convert: the browser tool or the agent
There are two distinct paths, and most people will use the first one.
The free browser tool. If you have a CSV or Excel file in front of you and just want a .QBO, the simplest route is the converter. You drop the file in, map the Date, Description, and Amount columns, pick QBO as the output, and download the file. It runs entirely client-side in your browser, so the statement is never uploaded to a server. The free tier covers one full statement with unlimited transactions. No signup is needed to convert.
The agent path. If you live inside an AI assistant, or you are wiring conversion into an automated workflow, QBO Maker offers an MCP server and a Convert API on the Pro plan. Instead of opening a website, you let the model call a tool named convert_transactions_to_qbo and get a file back. This is the agent-native part, and it is what the rest of this guide covers.
What MCP is and why it matters here
MCP, the Model Context Protocol, is an open standard that lets AI assistants connect to external tools and data sources through a small server. When you add an MCP server to a client like Claude Desktop, the model can see the tools that server publishes and call them on your behalf during a conversation. It is the same mechanism that lets an assistant read a file, query a database, or, in this case, build a bank-import file.
The point is that the assistant does not need to know the .QBO format, the OFX structure underneath it, or how to set transaction IDs. It just calls one tool with your transactions and gets back a valid file. The format knowledge lives in the server, not in the prompt, so the result is consistent every time rather than something the model improvises.
If you want to understand the file the tool produces, our explainers on what a .QBO file is and the OFX format behind it cover the structure in plain terms.
Connect an MCP client to the QBO Maker server
The setup is the standard MCP flow. In broad strokes:
- Get a Pro key. The MCP server and Convert API are part of the Pro plan. Your account gives you an endpoint URL and an API key.
- Add the server to your MCP client. In a client such as Claude Desktop, add a new server entry pointing at the QBO Maker endpoint and supply your key. Other MCP-capable clients use the same idea with their own config file or settings panel.
- Confirm the tool appears. Once connected, the client lists the server's tools. You should see
convert_transactions_to_qbo, which takes a set of transactions plus account details and returns a.QBOfile. Related tools cover.QFXand.OFXoutput from the same input.
From then on the assistant can use the tool inside any conversation, the same way it would use any other connected capability.
Convert a CSV by talking to the assistant
With the server connected, the workflow is conversational. A typical exchange looks like this:
- Give the model your transactions. Paste the CSV rows into the chat, or in clients that read files, point it at the CSV on disk.
- Ask for the conversion. Something like: "Convert these to a QBO file for a checking account." The model parses the rows, maps the columns, and calls
convert_transactions_to_qbowith the dates, descriptions, amounts, and the account type you named. - Receive the file. The tool returns a valid
.QBO, which you save and import into QuickBooks. - Import it. In QuickBooks Desktop, go to
File → Utilities → Import → Web Connect Filesand select the file. The transactions land in your bank feed ready to review and categorize.
Because the server, not the model, formats the output, you do not get a hallucinated file with the wrong header or a made-up account ID. The assistant supplies the data; the server guarantees the structure.
The Convert API for scripts and pipelines
You do not have to involve a chat assistant at all. The same Pro endpoint is a plain HTTP Convert API you can call from a script, a serverless function, or a scheduled job. Send transactions and account details, receive a .QBO, .QFX, or .OFX file back.
That is the right fit when you want conversion built into something that already runs, for example a nightly job that pulls each client's exports and produces import files automatically, or an internal tool your team triggers without opening a browser. For accountants running the same close every month, this turns a manual step into an unattended one. Our guide on CSV to QBO for bookkeepers describes the manual version of that same monthly pipeline.
Privacy, accuracy, and which path to pick
A few things worth being clear about. The free browser tool is local-only: your statement is parsed on your own device and never sent anywhere. The MCP server and Convert API are hosted services, so transaction data you pass to them is processed on the server side, which is the trade-off you accept in exchange for automation and agent access. Pick the local tool when you simply need a file and care most about keeping data on your machine; pick the hosted path when you want an assistant or a pipeline to do the work.
On accuracy, every path produces the same well-formed output with unique transaction IDs that QuickBooks uses for matching and de-duplication. You can confirm any file with the OFX/QBO validator before importing. If the conversion is a one-off, there is no reason to set up MCP at all, just use the free converter. If you are an AI-first user or you automate this monthly, the agent path is what makes QBO Maker different: it is the converter your assistant can drive.
Ready to try it? Convert your first CSV to QBO free in the browser, then upgrade to Pro when you want the MCP server and Convert API.
Frequently asked questions
Do I need an API key or a paid plan to use the MCP server?
Yes. The MCP server and the Convert API are part of the Pro plan, and you connect with an account API key. The free browser converter at the tool page needs no signup and no key for a single file a full statement with unlimited transactions, but it is a manual, in-browser tool rather than something an assistant can call.
Which AI clients can connect to it?
Any client that supports the Model Context Protocol. That includes Claude Desktop and a growing list of MCP-capable assistants and IDEs. You add the QBO Maker endpoint as a server in the client's MCP settings, supply your key, and the convert_transactions_to_qbo tool becomes available in your conversations.
Is my bank data uploaded when I use the agent path?
Yes, with the hosted MCP server and Convert API, the transactions you pass are processed on the server, since the assistant or your script is calling a remote endpoint. That is different from the free browser tool, which converts entirely client-side and never sends your file anywhere. If keeping data fully local is the priority, use the browser converter instead.
Can the assistant read my CSV from a PDF statement?
The conversion tools work on structured transaction data, not scanned images. If you only have a PDF, you need the transactions in CSV or spreadsheet form first. Some assistants can extract a table from a text-based PDF for you, but a scanned image statement needs OCR, which dedicated PDF-to-QBO tools handle better. See converting a PDF bank statement to QBO for that situation.