MCP App Store
by KeenEthics
KiwiBooks icon

KiwiBooks MCP Server for ChatGPT

By KiwiBooks Inc.

Overview

KiwiBooks is bookkeeping and tax software for freelancers, sole proprietors and small businesses. Connect it to work with your books in plain language. Ask about your money: what you spent on software this quarter, which invoices are overdue, your profit and loss, your mileage, and what your next estimated tax payment should be. Get the bookkeeping done: categorize transactions, create and send invoices, record payments, log business trips, add contacts, record estimated tax payments, and file receipts and bills. KiwiBooks scans each receipt and matches it to the bank transaction it supports. Every change is checked against your account's permissions and recorded in your audit log. You choose which business each file belongs to. KiwiBooks never moves money: it keeps your records and sends the invoices you ask it to.

How to connect

  1. ChatGPT: Open the KiwiBooks listing in the ChatGPT app directory and choose Connect. ChatGPT listing KiwiBooks exposes 43 tools here.

Tools

kiwibooks_add_project_costs

ChatGPT
Use this to group a business’s expenses and bills into a project as its costs, optionally billed to one of the project’s clients (billToContactId makes every added cost billable to that client). Take ids from projects.list_assignable_costs: transactions categorized as expenses (a refund is a negative cost), uncategorized money out, and reviewed bill documents with an amount, paid or not; never a row categorized outside expenses (income, assets, equity…), a book entry, a row already in a project or on an invoice. A bill and the transaction that pays it never both count: adding one of them refuses the other, and a request naming both is refused. A refund cannot be added with a recipient. Up to 200 ids across transactionIds and documentIds. Grouping never changes the transaction or bill itself. Safe to retry after a timeout: ids that are not reachable are skipped and listed in notFound, and the call fails with not_found only when none is. Needs KiwiBooks Pro and the Projects feature enabled; a project on an account that has left Pro stays readable but read-only. Refused as a whole, with nothing changed, for an archived project. Returns the ids added, the ids not found and the recipient.

kiwibooks_apply_invoice_legacy_repair

ChatGPT
Use this after invoices.legacy_repair_preview to apply ONE chosen outcome per legacy payment row. KEEP_AS_MANUAL_PAYMENT clears the old tag: the row stays as the owner’s own manual payment and the invoice stays paid by it. REPLACE_WITH_DEPOSIT (with depositTransactionId, a real unlinked money-in transaction of this business) removes the row KiwiBooks created and links that deposit as the invoice’s payment instead (an uncategorized deposit is categorized to revenue, with the invoice’s sales tax booked to Sales Tax Payable); the invoice’s status follows the linked money. Rows you do not send are left exactly as they are; nothing is applied automatically. Each row is re-checked against the live books and applied on its own: refused rows (closed period, void or missing invoice, a deposit that is not an unlinked money-in row) are reported beside the applied ones, and a call that applies nothing fails with the first reason. Up to 100 rows per call.

kiwibooks_categorize_transactions

ChatGPT
Use this to categorize one transaction by assigning it to an expense or income category, when the user asks to categorize, classify or re-file it. Requires transactionId and accountId (the category id); find both with kiwibooks_search_transactions first. One transaction per call. The result is marked NEEDS_REVIEW so the owner can confirm it in KiwiBooks. Refused for a transaction dated in a closed (locked) period, for adjustment entries, and for a category that does not fit the transaction (for example an expense filed to an income category). Returns the updated transaction with its category name.

kiwibooks_create_contact

ChatGPT
Use this to add a customer (CLIENT), vendor (VENDOR) or other contact, for example before invoicing someone new. Search with kiwibooks_search_contacts first: a contact with the same name and company is refused as a duplicate. Needs a name or a company name (or both) and at least one type; email and phone are optional. The contact belongs to the selected business unless shared is true. Returns the created contact with its id.

kiwibooks_create_invoice

ChatGPT
Use this to draft an invoice or an estimate (type ESTIMATE) with line items. It is created as a DRAFT and is not emailed to anyone. Amounts are dollars; salesTax is a percent rate; discount is dollars off unless discountType is PERCENT. To bill project costs, pass projectId and, on each line that bills a cost, its sourceTransactionId or sourceDocumentId: the invoice then reserves those costs (a cost must be billable, addressed to this customer, not a refund and not on another invoice; voiding or deleting the invoice releases them). Needs KiwiBooks Pro. Returns the created document with its number, totals and id. Refused when the issue date falls in a closed (locked) period.

kiwibooks_create_manual_bank_account

ChatGPT
Use this to add a bank or credit card account that is not linked through Plaid, so statements can be uploaded to it. The account is filed under THIS business (the business you pass). Reuses the same manual bank when institutionName matches one already added (ignoring capitals and extra spaces), so several accounts at one bank share it. Not for banks that connect automatically: connecting those happens in the KiwiBooks app, and a manual account does not sync. Check kiwibooks_list_bank_accounts first so you do not add a duplicate. Returns the new account id and its display label.

kiwibooks_create_project

ChatGPT
Use this to create a project in the selected business, to group its expenses and invoices and see their margins. Give a name (unique within the business, ignoring capitals and spacing) and optionally a budget, start and target dates, notes and the clients it may bill — verified client contacts only (ids from projects.suggest_clients or kiwibooks_search_contacts). The business comes from the connection, never from the input, and a project stays in it for good. Personal Finances cannot have projects. Status defaults to ACTIVE. Returns the project. Needs KiwiBooks Pro (a Free account reads projects but cannot change them) and the Projects feature to be enabled. An archived project refuses edits until it is reactivated.

kiwibooks_create_transaction

ChatGPT
Use this to record one income or expense transaction the user asks you to add or log. Requires date, description and amount (positive for income, negative for expense); optionally accountId (the category), merchantName and memo. Without accountId KiwiBooks categorizes it automatically. For a receipt with its file, use kiwibooks_record_receipt; for many rows from a statement, use kiwibooks_import_transactions. Refused when the date falls in a closed (locked) period. Returns the created transaction (id, date, signed amount, category, review status) and a duplicateWarning when a similar transaction already exists — check it before creating another.

kiwibooks_dismiss_bank_account_merge_suggestion

ChatGPT
Use this to decline the offer to merge a manual (statement) account into a connected one: the suggestion (mergeSuggestedIntoAccountId in bank_accounts.list) is cleared and both accounts stay as they are. bankAccountId is the manual account. Nothing else changes, and calling it with no suggestion is harmless.

kiwibooks_get_financial_overview

ChatGPT
Use this first for "how is the business doing" questions: the Finance Hub summary for one business and tax year — income, expenses and net income (the same figures as the profit and loss report for the full year, with cost of goods sold counted in expenses and collected sales tax never counted as income), book cash, outstanding and overdue receivables, how the estimated tax is stated for this business, the next quarterly estimated tax payment when one is overdue, due within 30 days or includes an amount for earlier quarters (amountDue is what is still to pay for it; includesCatchUp is the federal part that makes up for earlier quarters; with no taxYear, in the first half of January it is still the prior tax year's last installment, until that one is due), for a C corporation that is its own Form 1120-W installment, never the owner's 1040-ES (form says which), and the counts that need attention (uncategorized transactions, missing receipts, and transactions in groups of exact duplicates: same date, amount and description, search status duplicates, not possible_duplicates). Cash and receivables are as of today in the year in progress, or the year-end for a past year. One business per call. For line-by-line figures use kiwibooks_get_profit_and_loss or kiwibooks_get_report; for the transactions behind a count use kiwibooks_search_transactions. Years follow the business's accounting period: tax year N is the period ending in N (for a July start, FY 2026 is Jul 2025 to Jun 2026); the result states the dates covered.

kiwibooks_get_invoice

ChatGPT
Use this to read one invoice or estimate by id or number: status, dates, customer, line items, totals, balance and how many payments are linked. To find invoices by status or customer, use kiwibooks_search_invoices first.

kiwibooks_get_mileage

ChatGPT
Use this for questions about miles driven, the mileage deduction, the IRS rate or recent trips. Returns, for one calendar year: business miles, approved business trip count, deductible miles, IRS rate, the standard-rate deduction, how many vehicles use each method that year (standard, actual, undecided; elected per vehicle per year), and a page of trips (date, vehicle, miles, type, purpose, id) filterable by date range, vehicle and type. When deductionViaExpenseReports is true the deduction is NOT a per-mile figure: relay deductionNote instead of quoting a dollar amount. Mileage years are CALENDAR years (IRS rates are per period: one rate for most years, two for 2022; mileageRates lists them and the deduction is priced per period, so never recompute it as miles x mileageRate), even for a business on a fiscal year. To log a trip use kiwibooks_log_trip.

kiwibooks_get_profit_and_loss

ChatGPT
Use this for profitability questions about one business: revenue, cost of goods sold, gross profit, expenses and net income for a tax year, quarter or month, with EVERY income, COGS and expense line by account. Defaults to the full tax year, the app standard; use "ytd" only when asked, because it stops at today and leaves out month-end entries such as mileage postings. Returns the dates covered, the accounting basis (cash or accrual) and the disclosures the app shows (uncategorized rows, uncollected invoices). One business per call; reports never combine businesses. No custom date ranges or prior-period comparison. For the transactions behind a line use kiwibooks_search_transactions; for tax estimates use kiwibooks_get_tax_summary. Years follow the business's accounting period: tax year N is the period ending in N (for a July start, FY 2026 is Jul 2025 to Jun 2026); the result states the dates covered.

kiwibooks_get_project_summary

ChatGPT
Use this to answer "how is this project doing": total costs, ready to bill, invoiced and received (both net of sales tax, with the gross receipts and the tax received beside them), outstanding, overdue and awaiting-payment balances with counts, expected and cash margins, budget use, costs by category, the target-date countdown, and every cost row the figures leave out with its reason (a row that needs review counts 0 until fixed or removed; a payment of a bill that is already a cost is not counted twice). Definitions: invoiced = Σ (total − tax) over issued invoices (never drafts or void); received = each receipt net of its proportional sales-tax share; outstanding, overdue and awaiting are gross stored balances; expected margin = invoiced − costs; cash margin = received − costs; a bill counts whatever its payment status. Returns asOf, the UTC calendar day the figures are as of. For the cost rows themselves use projects.list_costs; for the invoices, projects.list_invoices. Reading projects needs no particular plan: Free connections can call this, and an owner who has left KiwiBooks Pro still reads and exports their projects (they become read-only). Creating or changing a project needs KiwiBooks Pro. Figures and "today" are on the UTC calendar day.

kiwibooks_get_report

ChatGPT
Use this to read one of the KiwiBooks reports for one business, choosing it with report: balance_sheet, cash_flow, general_ledger, receivables_aging, payables_aging, sales_tax, vendor_1099, assets, customer_statements or meal_substantiation. Each takes the parameters its report page takes (taxYear for all; asOf for the balance sheet and aging; period/periodValue and state/city for sales tax; account for the ledger; customer/status for statements); a parameter that does not apply is refused. Returns the report with explicit totals, lines and the notes the app shows, plus ids for follow-up calls. One business per call; reports never combine businesses. For profit and loss use kiwibooks_get_profit_and_loss; to page through every ledger line use ledger.entries; for a single account balance use ledger.account_balance. Years follow the business's accounting period: tax year N is the period ending in N (for a July start, FY 2026 is Jul 2025 to Jun 2026); the result states the dates covered.

kiwibooks_get_tax_summary

ChatGPT
Use this for tax questions about one business and the owner's return: the business's net profit, taxable net income and deductions (vehicle, depreciation, home office); how its profit is taxed; the owner's personal Form 1040 estimate (federal income, self-employment and state tax, effective rate, filing status); and the quarterly estimated-payment plan with due dates, amounts due and paid. In quarterlyPlan.federal, until the return is due or the plan is marked filed, a quarter's estimatedDue is what that quarter asks now, not a quarter of the year: a quarter whose due date has passed shows what was paid for it, or, with nothing paid, its installment plus what the paid quarters before it lacked; the next one adds what earlier quarters lacked (its catchUp, with a warning) and payments ahead of the plan lower later quarters; scheduled is the installment before payments are counted, and paid counts a quarter marked paid on the plan when no payment is recorded for it (paidSource). State installments are an even split and do not catch up. A Schedule C, E or F business owes no tax of its own, so it reports its SHARE of the 1040 (0 to 1), not dollars; a C corporation reports its own corporate tax and 1120-W installments; a partnership or S corporation is taxed on its owners' returns. W-2 wages count once: the larger of the tax profile's W-2 wages and the paychecks recorded in Personal, never their sum. ownerReturn says which (w2WagesUsed, w2WagesSource) and what was left out: recorded paychecks a profile figure at least as large replaced (bookedW2WagesLeftOut), or a smaller profile figure the paychecks replaced (profileW2WagesLeftOut). Self-employment tax is coordinated with two wage figures: seSocialSecurityWages (Schedule SE line 8a, the self-employed person's own W-2 wages) and seMedicareWages (Form 8959 line 10, every W-2 Medicare wage on the return, both spouses' on a joint return). On a joint return selfEmployedW2Wages is the self-employed spouse's part of the profile's W-2 wages (null: not answered, so all of them count as theirs). It reads null with two Schedules SE, and while "Your W-2 wages" is on screen (the split then comes from accountOwnerW2Wages); otherwise it reads the stored answer, which a figure uses only where its field is on screen. While it is not answered and could matter, selfEmploymentTaxCouldRiseBy says by how much self-employment tax could rise (0 otherwise) and a warning asks for it (tax.update_profile). estimatedTax includes additionalMedicareTaxOnWages (Form 8959 Part I, 0.9% of W-2 wages above the threshold for the filing status). additionalMedicareTaxWithheld (Form 8959 line 24) is a credit beside the tax profile's withholding, never part of estimatedTax; additionalMedicareTaxWithheldBasis says whether it is the employer rule or is assumed equal to Part I because a joint return has not said how the wages are split. selfEmploymentSchedules has one Schedule SE, or two when both spouses have self-employment income, each with its own line 8a and 400 floor; with two, selfEmployedW2Wages reads null and accountOwnerW2Wages is the account owner's own W-2 wages (the spouse's are the rest of w2Wages). A null accountOwnerW2Wages counts all of them for each, unless a stored selfEmployedW2Wages is answered: then the lower-tax split that answer allows, whichever spouse holds it. selfEmploymentTaxCouldRiseByWhoRuns is how much self-employment tax could rise if the tax profile said who runs each business (0 when it cannot). Income in a category marked not taxed (a Personal gift, for example) is left out of taxable net income and reported in its own figure, with the other income the estimate leaves out. Income in a category with no tax line is counted as taxable income (unmappedTaxableIncome says how much, with a warning). A gain or loss on investments is counted on the personal return, not in a business's profit: a Schedule C, E or F business reports it as capitalGainOnOwnerReturn, and ownerReturn says what the estimate counts of the net (a net loss up to capitalLossLimit). capitalLossCarriedToNextYear is the los…

kiwibooks_import_bank_statement

ChatGPT
Use this to import a bank or credit-card statement export: pass the raw CSV text (csv), optionally with a column mapping (header names or 0-based indexes; detected from the header row when omitted), or rows you already parsed. Run it first with dryRun: true (the default) — nothing is written and each row comes back as new, duplicate (already in the books with the same date, amount and description) or invalid (unreadable date or amount, or a closed period) — then repeat with dryRun: false to import. Imported rows are categorized from the file's category column when it names a category, else by the owner's rules and history. Up to 500 rows per call; split larger files. Re-sending rows is safe (duplicates are skipped). For a PDF statement, upload it with kiwibooks_upload_document instead. Returns counts and a per-row report. Pass bankAccountId (kiwibooks_list_bank_accounts, or kiwibooks_create_manual_bank_account) to record which account the statement belongs to; the rows then read as that account in the Source column. When that account already holds a matching row (typically from its bank feed), the result lists possibleDuplicates: ask the user which to keep, then call kiwibooks_resolve_possible_duplicate. Read the flagged rows again later with kiwibooks_search_transactions (status possible_duplicates, optionally bankAccountId). To catch these BEFORE importing, preview with bankAccountId: each new row that looks like a row the account already holds carries possibleDuplicateOf ({ transactionId, date, description, amount }). Show them to the user, then import with dryRun: false; the rows to approve go in importAnyway by their row number in the preview (the same numbering, 1-based; the rows themselves are the ones you send). An approved row is recorded as not a duplicate and is not flagged; the other rows are still checked after import. Always ask the user which business, or Personal, this belongs to and pass it in business (REST: businessId); it is never assumed, even when the account has one business or an active business is set. Without it nothing is stored or scanned and the call fails with business_required, whose choices list every business you may use ({ businessId, name, kind }): ask the user, then repeat the call with that businessId (an MCP client that supports elicitation is asked in-line).

kiwibooks_import_statement_document

ChatGPT
Use this to turn the rows KiwiBooks read from an uploaded bank-statement PDF into transactions of this business. Steps: upload the PDF with kiwibooks_upload_document (documentType: BANK_STATEMENT) or kiwibooks_prepare_upload (documentType: BANK_STATEMENT) for a large file, call this tool with dryRun: true to see every row (date, description, signed amount: negative = money out) and whether it is new or already in the books, then call it with dryRun: false, optionally passing rows to import only some. It is refused while KiwiBooks is still reading the file, so retry the dry run after a short wait. Rows already imported (same date, amount and description) are skipped, so repeating is safe. New transactions are uncategorized and attached to the statement. Also refused after the read failed, or when the statement was already imported. For CSV statements use kiwibooks_import_bank_statement instead. Pass bankAccountId (from kiwibooks_list_bank_accounts, or kiwibooks_create_manual_bank_account) to record which account the statement belongs to; the rows then read as that account in the Source column. When the account already holds a matching row (typically from its bank feed), the result lists possibleDuplicates: ask the user which to keep, then call kiwibooks_resolve_possible_duplicate. Read the flagged rows again later with kiwibooks_search_transactions (status possible_duplicates, optionally bankAccountId). To catch these BEFORE importing, dry-run with bankAccountId: each new row that looks like a row the account already holds carries possibleDuplicateOf ({ transactionId, date, description, amount }). Show them to the user, leave those rows out of rows, or pass their index in importAnyway (together with rows) to import them anyway; an approved row is recorded as not a duplicate and is not flagged. Row indexes are the statement row numbers shown in the dry run, in rows and importAnyway alike. business is optional here: the statement's own business (chosen when it was uploaded) is used, and one that differs is refused. For a statement that sits in no business, ask the user which business, or Personal, and pass it.

kiwibooks_import_transactions

ChatGPT
Use this to create many transactions at once from data you extracted (e.g. a bank statement you OCR'd), up to 500 rows per call. amount: positive for income, negative for expense. Rows without accountId are categorized automatically (by the statement category label when it matches a category name, then by the owner's rules and history). A label is not used where the row's own facts contradict it (money out labelled as income, a card payment with no credit card account, and the like): categoryLabelsNotUsed lists those rows with the reason, to tell the user. Use this for statements; use kiwibooks_record_receipt for a single receipt that should have its file attached, and kiwibooks_create_transaction for one manual entry. Re-sending a row is safe: a row with the same date, amount and description as an existing transaction is skipped. Rows dated in a closed (locked) period are refused one by one. Returns how many were imported and skipped, and each refused row with the reason. Pass bankAccountId (kiwibooks_list_bank_accounts, or kiwibooks_create_manual_bank_account) to record which account the statement belongs to; the rows then read as that account in the Source column. When that account already holds a matching row (typically from its bank feed), the result lists possibleDuplicates: ask the user which to keep, then call kiwibooks_resolve_possible_duplicate. Read the flagged rows again later with kiwibooks_search_transactions (status possible_duplicates, optionally bankAccountId). To catch these BEFORE importing, call first with dryRun: true and bankAccountId: each new row that looks like a row the account already holds carries possibleDuplicateOf ({ transactionId, date, description, amount }). Show them to the user, then import: drop the rows they reject, and pass the index of each one they approve in importAnyway (0-based, the index in transactions); an approved row is recorded as not a duplicate and is not flagged. The other rows are still checked after import.

kiwibooks_list_bank_accounts

ChatGPT
Use this to see this business's bank feeds: each bank connection (institution, status, last sync, whether it needs reconnecting) with its accounts (name, type, last digits, balances, whether sync is on, and the business each account files under). Accounts of the same bank login that belong to another business are left out; accounts not assigned to any business yet are shown so you can assign them with bank_accounts.assign_business. Use the ids with kiwibooks_sync_bank_accounts and the other bank_* operations. Connecting a new bank or renewing a bank login happens only in the KiwiBooks app; a connection with kind "manual" was added by hand (bank_accounts.create_manual) and never syncs; when its card was later connected, mergeSuggestedIntoAccountId names the connected account (bank_accounts.merge_manual). Not for transactions — use kiwibooks_search_transactions.

kiwibooks_list_businesses

ChatGPT
Use this first. Lists the businesses (and the personal entity) this connection can work on, marks the active one, and states whether the plan allows changes. Every other tool takes an optional business (name or id); without it they use the active business, or the only one. For a CPA firm connection it lists every client business, then the firm’s own practice when this person can open it (first 100; kiwibooks_list_clients pages and filters them).

kiwibooks_log_trip

ChatGPT
Use this to log a business or personal trip for mileage: date, vehicle (id or name), miles (or odometer readings) and a purpose. It is recorded as approved, on the business it is logged to. Not for mileage totals or the trip list: use kiwibooks_get_mileage. The vehicle must already exist in KiwiBooks; an unknown or ambiguous name returns the list of vehicles. Refused when the date falls in a closed (locked) period. Returns the trip with its id, reference number and the vehicle and business it was logged to.

kiwibooks_merge_manual_bank_account

ChatGPT
Use this when a card or account you added by hand for statement uploads (a "manual" account) has since been connected through Plaid, so the account keeps one history. Every transaction of the manual account moves to the connected account (bankAccountId is the manual one, intoBankAccountId the connected one) and takes its bank and account name; the manual account is then removed, along with its bank if it has no other account. Both accounts must file under the same business, or it is refused: move one first with bank_accounts.assign_business. The connected account must have finished setup. Afterwards, moved transactions that look like ones already in the connected account are flagged; the result counts them (review them with kiwibooks_search_transactions: status possible_duplicates, bankAccountId = the connected account). bank_accounts.list shows a suggested target in mergeSuggestedIntoAccountId. This cannot be undone.

kiwibooks_prepare_upload

ChatGPT
Use this as step 1 of uploading a receipt, bill, refund, uploaded-invoice or bank-statement file (PDF, JPEG, PNG or HEIC, up to 20 MB). It stores nothing by itself: it returns an uploadToken and a one-time upload target (url plus form fields) that expire after 15 minutes. Step 2: POST the file to upload.url as multipart/form-data with every upload.fields entry, then the file last as the field "file". Step 3: call documents.finalize_upload with the uploadToken. A receipt is filed like the app's receipt import: for this business, scanned within the monthly allowance (Free: 10 scans a month; past it the file is still saved, unscanned) and matched to bank activity; an exact copy of a file already on file is skipped on Pro. An INVOICE (issued outside KiwiBooks) is filed the same way and matched to the deposit that paid it. kiwibooks_record_receipt is the alternative step 3 only for a cash expense no bank feed will bring in. For several files at once, start an import with documents.start_import and pass each importItemId here. Do not send the file content to this tool; fileSize must be the exact byte count. For files up to 4 MB, kiwibooks_upload_document takes the bytes directly. In a chat app that cannot make the POST (its sandbox cannot reach the upload storage), call kiwibooks_create_upload_link and give the user the link instead. Request cost: a presigned upload is 2 requests (documents.create_upload, then documents.finalize_upload; the POST to upload.url does not count), documents.upload is 1, and polling documents.get counts too, against this connection's limit of 60 requests a minute on Free or 120 on Pro. Uploads are also capped per account: 20 a minute outside an import, 100 a minute for the files of a documents.start_import import, so start an import for more than a few files. Over a limit the call fails with 429 rate_limited and Retry-After (seconds); nothing was stored, so wait that long and repeat the same call. Always ask the user which business, or Personal, this belongs to and pass it in business (REST: businessId); it is never assumed, even when the account has one business or an active business is set. Without it nothing is stored or scanned and the call fails with business_required, whose choices list every business you may use ({ businessId, name, kind }): ask the user, then repeat the call with that businessId (an MCP client that supports elicitation is asked in-line). For a file of an import (importItemId) business is optional: the import's business is used.

kiwibooks_preview_invoice_legacy_repair

ChatGPT
Use this to list the payments the retired "Mark paid" recorded for invoices before 2026-10-22 (manual rows KiwiBooks created itself, still tagged with the invoice) and what to do with each. For every row it names the invoice and proposes one of: keep as a manual payment (no bank deposit matches; the row becomes the owner’s own payment and the invoice stays paid), replace with a deposit (exactly one real deposit matches exactly, from the same customer, within 7 days — it becomes the payment and the row is removed so income is counted once), or needs attention (the invoice is void or gone, the period is closed, the amounts disagree, or two deposits match — the possible deposits are listed). Reading changes nothing. Returns the rows with their proposals, the count and a tally by outcome. Apply a choice per row with invoices.apply_legacy_repair.

kiwibooks_record_estimated_tax_payment

ChatGPT
Use this to record an estimated-tax payment the owner already made: a 1040-ES payment (federal or state) on the owner's PERSONAL business — which needs a quarterly plan for that calendar year (tax.save_quarterly_plan) — or a C corporation's own 1120-W payment on that corporation. It counts toward the paid totals on the Tax page and tax.summary. KiwiBooks does not pay anything; it only records. One payment per quarter and jurisdiction: to correct one, delete it (tax.delete_estimated_payment) and record it again. Returns the recorded payment and its id. Years follow the business's accounting period: tax year N is the period ending in N (for a July start, FY 2026 is Jul 2025 to Jun 2026); the result states the dates covered.

kiwibooks_record_invoice_payment

ChatGPT
Use this when a customer has paid an invoice. Three ways, one per call. (1) Link a deposit: pass transactionId and that bank deposit becomes the payment — nothing new is created. A deposit with no category is categorized to the business’s revenue account, with the invoice’s sales tax booked to Sales Tax Payable; a deposit that already has a category keeps it. A deposit naming no contact takes the invoice’s customer, and its memo notes the invoice number (its bank description is kept). (2) Record a manual payment: omit transactionId and KiwiBooks creates a money-in transaction you own, for amount (default: the remaining balance) on paidDate, in account (Cash on Hand, or a bank account id), linked to the invoice. (3) Awaiting deposit: pass awaitingDeposit: true when the customer paid but the money is not in the books yet; nothing is recorded, the invoice stays open and is flagged until a deposit is linked (a Pro bank import links a strongly matching deposit automatically). In every case the invoice’s PAID or PARTIALLY_PAID status follows what its linked money covers; KiwiBooks never records income without a transaction. Not for estimates. Refused when the invoice is in a closed (locked) period, for a money-out transaction, for an amount above the balance, and for a second deposit on an invoice already paid. To undo, unlink with invoices.unlink_payment, or void with invoices.set_status. Returns the invoice and the transaction that is the payment.

kiwibooks_record_receipt

ChatGPT
Use this ONLY to record a cash expense that will never arrive through a bank feed or statement import as a new transaction, with the uploaded receipt attached. It creates a real expense, so a purchase paid by card or bank would then be counted twice: for those, finalize the upload with documents.finalize_upload (KiwiBooks files the receipt and matches it to the charge) or attach it to the existing charge with documents.link_transactions. First call kiwibooks_prepare_upload and upload the file, then call this with the uploadToken and the details you read. amount is the positive total paid. Not for income or statements (use kiwibooks_import_transactions), and not for a file of an import. Refused when the date falls in a closed (locked) period or the upload belongs to another business. Returns the created expense (id, date, amount, category). business is optional here: it is taken from the uploadToken (the business chosen when the upload was prepared). If you pass one that differs, the call is refused.

kiwibooks_resolve_possible_duplicate

ChatGPT
Use this after a statement import (kiwibooks_import_statement_document, kiwibooks_import_bank_statement or kiwibooks_import_transactions) returned possibleDuplicates: each entry names an imported transaction that looks like a copy of a row already in the same bank account (e.g. the same purchase from the bank feed). Pass the imported row as transactionId (the transactionId of the entry, never its duplicateOfId) and decide: delete_copy permanently deletes that imported row and keeps the other one (it cannot be undone; linked receipts go back to Unmatched), not_duplicate keeps both and remembers the pair so it is not flagged again. Ask the user before choosing unless they already said. Refused in a closed (locked) period for delete_copy, as a normal delete is, and on a read-only business (free plan) for either decision. A transaction that is not flagged is refused with conflict not_flagged. Returns the transaction id and the decision.

kiwibooks_search_contacts

ChatGPT
Use this to find a customer, vendor or other contact and its id — for example the customerId that kiwibooks_create_invoice needs. Covers the contacts of the selected business plus contacts shared across all businesses, as the app does with that business selected. Filter by type and by text (name, company, email). Returns a page of matches (name, company, types, email, phone, id) and the total. Contacts still awaiting review (auto-created from bank data) are not listed. If nothing matches, create the contact with kiwibooks_create_contact.

kiwibooks_search_documents

ChatGPT
Use this to find receipts, bills, refunds, bank statements and other uploaded documents, and to answer "which receipts are unmatched", "what needs review", "which bills are unpaid" or "is the statement processed yet". A receipt, bill or refund is Matched when it is linked to a real bank or card transaction, otherwise Unmatched with a reason. Filters by type, status, OCR status, tax year or date range and text (also item names and original file names); returns a page of documents (reference, type, status, vendor, date, amount, original file name, businesses, linked transactions, id). For the OCR text and line items of one document, use the documents.get operation (GET /api/v1/documents/{documentId}). Not for transactions — use kiwibooks_search_transactions. Years follow the business's accounting period: tax year N is the period ending in N (for a July start, FY 2026 is Jul 2025 to Jun 2026); the result states the dates covered.

kiwibooks_search_invoices

ChatGPT
Use this to find invoices or estimates and to answer "what is outstanding / overdue / paid". Filters by tax year, status, type and customer; returns totals for the period — including the invoices flagged "customer paid, no deposit yet" and their open amount, which is not yet income on a cash basis — plus a page of matches (number, status, customer, dates, total, balance, awaitingDepositAt, id). For one invoice with its line items, use kiwibooks_get_invoice. Years follow the business's accounting period: tax year N is the period ending in N (for a July start, FY 2026 is Jul 2025 to Jun 2026); the result states the dates covered.

kiwibooks_search_projects

ChatGPT
Use this to find a business’s projects and see how each stands: total costs, invoiced and received (both net of sales tax), what is ready to bill, outstanding and overdue balances, expected and cash margins, budget use, clients and the target-date countdown. Filters by status (open, all, or one status), text in the name and readyToBillOnly; sorts by last update, name, start or target date; pages ten at a time. Returns a page of projects with their figures and ids. Expected margin = invoiced (before sales tax) − total costs; cash margin = received (net of the proportional sales-tax share) − total costs; costs are the expenses and bills grouped into the project, whatever the bills’ payment status. For one project’s full figures with the category breakdown and the rows left out, use kiwibooks_get_project_summary. Reading projects needs no particular plan: Free connections can call this, and an owner who has left KiwiBooks Pro still reads and exports their projects (they become read-only). Creating or changing a project needs KiwiBooks Pro. Figures and "today" are on the UTC calendar day.

kiwibooks_search_transactions

ChatGPT
Use this to find transactions and answer questions about income, spending and transaction counts in a tax year. Filters by tax year, type (income or expense), category group or category id, status (needs_review, missing_receipt, uncategorized, duplicates, possible_duplicates) and free text (description, merchant, memo, reference number, contact). Returns the year's totals (totalIncome, totalExpenses, pendingSubstantiation = transactions still missing a receipt, uncategorized) plus a page of matches (date, description, merchant, amount, category with its categoryId, review status, id). Amounts are signed: positive = money in, negative = money out. Split transactions appear as one row per allocation. Every row carries possibleDuplicateOfId (null unless an import flagged it): status possible_duplicates lists the flagged rows, optionally for one bankAccountId, so you can review them after an import. Custom date ranges are not supported — pick the tax year. Does NOT return totals by category, month, vendor or account: use kiwibooks_summarize_transactions for those. Years follow the business's accounting period: tax year N is the period ending in N (for a July start, FY 2026 is Jul 2025 to Jun 2026); the result states the dates covered.

kiwibooks_send_invoice

ChatGPT
Use this to email an invoice or estimate to a customer, with its PDF attached and your payment options in the body. It sends real email to a third party immediately — confirm the recipient with the user first. The recipient defaults to the customer email on the invoice; the result echoes the address used. A DRAFT becomes SENT. Limits: Pro includes a monthly allowance of invoice emails, plus hourly, daily and per-recipient caps; addresses that bounced or complained are refused. Refused for a draft issued in a closed (locked) period. To mark an invoice sent without emailing, use invoices.set_status.

kiwibooks_set_active_business

ChatGPT
Use this to choose the business later calls act on when they do not pass business. Takes a business name or id from kiwibooks_list_businesses. Changes no bookkeeping data.

kiwibooks_summarize_transactions

ChatGPT
Use this to answer "how much did I spend on X", "income by month", "top vendors" or "what came through each bank account" over a period: totals grouped by category, month, vendor or bank account, each with count, money in, money out and net. Signs follow the transactions list (money in positive, money out negative; a refund of an expense counts as money in). Use type to keep only income or only expenses. This reads transactions as recorded (cash basis, before any accrual adjustment): for the official figures use the profit and loss report. To list the transactions behind a group, use kiwibooks_search_transactions. Years follow the business's accounting period: tax year N is the period ending in N (for a July start, FY 2026 is Jul 2025 to Jun 2026); the result states the dates covered.

kiwibooks_sync_bank_accounts

ChatGPT
Use this to pull the latest transactions and balances from the bank for one connection (connectionId) or, when connectionId is omitted, for every connected bank feeding this business. Each bank imports up to three pages of new activity per call; more arrives on the next call or the scheduled sync (hasMore). New transactions are auto-categorized as in the app. Paused banks, banks that need reconnecting and banks still in setup are refused with the reason — renewing a bank login happens only in the KiwiBooks app. Returns per bank: imported, updated, and any refusal.

kiwibooks_upload_document

ChatGPT
Use this to upload a receipt, bill, refund, uploaded-invoice or bank statement file (PDF, JPEG, PNG or HEIC, at most 4 MB) by sending its bytes as base64 in fileBase64, when you cannot make a multipart POST yourself. It files the document exactly as documents.finalize_upload does: a receipt through the receipt import (scanned within the monthly allowance — Free: 10 a month, past it saved unscanned — skipped when the same file is already on file on Pro, then matched to its bank transaction); an INVOICE the same way, matched to the deposit that paid it; a statement stored and read. For a statement, preview its rows with kiwibooks_import_statement_document (dryRun: true), retrying while KiwiBooks is still reading it, then import. For any other type, poll documents.get until ocrStatus is COMPLETED, FAILED or SKIPPED, then correct it with documents.update. For files over 4 MB use documents.create_upload. A file attached to a chat is usually far too large to pass here: call kiwibooks_create_upload_link and give the user the link instead. Returns the document id and what happened to it. Request cost: a presigned upload is 2 requests (documents.create_upload, then documents.finalize_upload; the POST to upload.url does not count), documents.upload is 1, and polling documents.get counts too, against this connection's limit of 60 requests a minute on Free or 120 on Pro. Uploads are also capped per account: 20 a minute outside an import, 100 a minute for the files of a documents.start_import import, so start an import for more than a few files. Over a limit the call fails with 429 rate_limited and Retry-After (seconds); nothing was stored, so wait that long and repeat the same call. Always ask the user which business, or Personal, this belongs to and pass it in business (REST: businessId); it is never assumed, even when the account has one business or an active business is set. Without it nothing is stored or scanned and the call fails with business_required, whose choices list every business you may use ({ businessId, name, kind }): ask the user, then repeat the call with that businessId (an MCP client that supports elicitation is asked in-line).

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/kiwibooks"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/kiwibooks)