> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myclerkbook.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Powered

> One name over three capabilities: document parsing, the myClerkBook Agent, and Statement Import.

**AI Powered** covers three capabilities that work differently from one
another. Parsing reads a document and fills the entry form in for you. The
Agent answers questions about your own figures in plain language. Statement
Import reads a bank statement you exported yourself, and it uses no AI at all.

They are grouped because that is how you meet them in the product. They are
explained separately here because they are metered separately, and treating
them as one thing is the quickest way to be surprised by a limit.

<CardGroup cols={3}>
  <Card title="AI Parsing" icon="file-arrow-up">
    A receipt, invoice or payment confirmation becomes a pre-filled entry you
    review. Metered per day.
  </Card>

  <Card title="myClerkBook Agent" icon="comments">
    Conversational analysis of your books, sold as an add-on to either plan.
  </Card>

  <Card title="Statement Import" icon="file-import">
    OFX, QFX and CSV from your own bank. No model, no parse allowance.
  </Card>
</CardGroup>

<Note>
  **How they are metered.** AI Parsing covers both the upload path and the
  connected mailbox path, drawing on one daily allowance shared between them.
  Statement Import is separate: it uses no AI and consumes none of your parse
  allowance.
</Note>

## AI Parsing

Parsing turns a financial document into a pre-filled entry form. It never saves
anything on its own: you see every extracted field, you change what is wrong,
and you confirm. An entry created from a parse you approved is recorded as one
you made, because the thing that matters is your confirmation and not the
extraction.

<Steps>
  <Step title="Give it a document">
    Upload one file, or a batch of up to 20 at once, from the **Upload** screen
    inside a book. A batch is read one file at a time, with progress shown per
    file. On a phone you photograph the receipt instead, which arrives with the
    mobile app.
  </Step>

  <Step title="Or connect a mailbox">
    A connected Gmail, Outlook or iCloud mailbox feeds incoming receipts,
    invoices and payment confirmations into the same pipeline. The book's
    **Email** screen lists synced messages with sender, subject and a snippet,
    and each carries a **Parse** action. See
    [Integrations](/features/integrations) for connecting one.
  </Step>

  <Step title="Review what came back">
    The form opens with the fields filled in and every one of them editable.
    Fields the reader was unsure of are flagged, so your attention lands there
    first.
  </Step>

  <Step title="Approve or dismiss">
    Approving creates the entry. Dismissing discards it. Either way the stored
    copy of your document is deleted at that moment.
  </Step>
</Steps>

**Both paths draw on one allowance.** Upload and connected mail are two doors
into the same pipeline and share a single daily counter, so eight uploads leave
two email parses on Basic rather than a separate pool.

## What AI Parsing reads

Two groups of formats, and the difference is in how each is handled rather than
in what you may send.

|                  | Formats                             | How it is handled                             |
| ---------------- | ----------------------------------- | --------------------------------------------- |
| Read as they are | JPEG, PNG, GIF, WebP, PDF, TXT, CSV | Read in the form you sent them                |
| Converted first  | DOC, DOCX, ODT, RTF, XLS, XLSX, ODS | Turned into plain text on our side, then read |

**Up to 10MB per file.** A converted file has a second ceiling on the amount of
text it produces, and a file that exceeds it is refused with a clear error
rather than quietly shortened. A truncated spreadsheet loses entries you
believe were captured, which is worse than a refusal you can act on.

<Warning>
  **TIFF and HEIC or HEIF are refused.** Those are photo formats rather than
  document formats, and they are a different problem from the conversion above.
  Save or export as JPEG, PNG or PDF first. Most phones will do it on share.
</Warning>

## What comes back, and what you confirm

Seven fields: type, amount, currency, date, the vendor or source name, a
suggested group, and whether it looks recurring. Each carries a confidence
value between 0 and 1, and anything below 0.6 is flagged on the confirm form so
the uncertain values are the ones you look at first.

Every value is a suggestion. Change any of them before you save, and add
groups, a description or a receipt exactly as you would on a manual entry.

## Your daily parse allowance

|                 | Basic    | Premium   |
| --------------- | -------- | --------- |
| Document parses | 10 a day | 100 a day |

The counter resets at midnight UTC, and uploaded files and parsed mail both
come out of it.

## What happens to your document

The file is held only for as long as the parse needs it and is deleted the
moment you approve or dismiss. Before any of its text reaches the reader it is
stripped of personal information, so the figures are read without your name,
your email address or an account number travelling alongside them. Nothing you
upload is used to train a model.

## The myClerkBook Agent

The Agent is a financial assistant you talk to, in the product and over
WhatsApp. It is an add-on to either plan rather than a third plan, so it stacks
on whichever plan you hold. See
[Plans compared](/plans-and-billing/plans-compared) for what it costs.

<CardGroup cols={2}>
  <Card title="Ask your books a question" icon="magnifying-glass">
    "Which client paid me most this quarter?" answered from your own figures,
    with documents you can drop straight into the chat.
  </Card>

  <Card title="Web search for context" icon="globe">
    Exchange rates, tax information and market conditions, alongside your data
    rather than instead of it.
  </Card>

  <Card title="Builds widgets and alerts" icon="table-cells">
    Describe what you want to see, or to be told, and it configures the
    instance. In the product only.
  </Card>

  <Card title="WhatsApp access" icon="whatsapp">
    Ask mode and read only. It answers questions across your account and writes
    nothing.
  </Card>
</CardGroup>

**Every tool that writes is off until you turn it on.** Permission is granted
per tool and per book, and starts denied. Listing your entries and fetching a
summary are available; creating, changing and deleting are not, until you allow
them in your integration settings. A tool call that fails, because a permission
is off or a value did not validate, says so in the conversation and tells you
what to do next.

**Included usage, or your own key.** The add-on comes with 10,000 credits of
usage a month on the in-house model, resetting with your billing cycle, and you
are told when you reach 80% and 95% of them. If it runs out, the chat stops accepting new messages and your history
stays readable. Nothing is deleted and nothing is locked. You can wait for the
next cycle, or connect your own Anthropic, OpenAI or Google key, which runs the
Agent under your own billing and draws no allowance at all. Your own key
applies to the Agent only and never to parsing.

**What the Agent is given.** A summary of the book and your last 10 entries.
Never your full history, your name, your email address or an internal
identifier. The conversation lives for the length of the session and is not
stored afterwards.

## Statement Import

Statement Import reads a bank statement you exported yourself, in **OFX, QFX or
CSV**, and turns it into entries you select, categorise and confirm. No bank
connection is involved and there is no facility to create one. You export the
file from your bank, and myClerkBook reads the file you chose to give it.

<Note>
  **It uses no AI, and it consumes none of your document parse allowance.**
  These are structured formats with a published grammar, so they are read
  directly rather than interpreted. There are no confidence scores here,
  because nothing is being guessed. The review step exists so you can choose
  and categorise rows, not so you can correct a reader.
</Note>

<Steps>
  <Step title="Export from your bank">
    Any OFX, QFX or CSV download will do. A CSV goes through a short
    column-mapping step, so myClerkBook knows which column holds the date, the
    amount and the description.
  </Step>

  <Step title="Review the table">
    Rows open in a table on the **Import** screen inside a book, not in the
    single entry form. Everything is editable in place, a group can be applied
    across a multi-row selection in one action, and a running count shows what
    you have selected against the allowances below.
  </Step>

  <Step title="Commit or dismiss">
    Committing writes your selection in one go. Dismissing discards it and
    costs you nothing.
  </Step>
</Steps>

**One import per calendar month, per book.** That single rule produces both
plan limits, because what differs between the plans is how many books you hold.

|                   | Basic     | Premium                     |
| ----------------- | --------- | --------------------------- |
| Books             | One       | Up to 5                     |
| Statement imports | 1 a month | 1 a month per book, up to 5 |

Premium allowances are not pooled. An unused allowance on one book cannot be
spent on another.

**The allowance is spent when you commit, not when you upload.** Opening the
wrong file, reviewing it and dismissing it costs nothing. The screen states
what you have left and when it resets before you start selecting.

**A file carries at most 1,000 rows**, on both plans. That is a guard against a
pathological file rather than a plan lever. Basic's cap of 100 entries a month
still applies and is counted per row, so a Basic book with 40 entries left this
month can commit 40 rows, and the screen says so before you begin rather than
after.

**Duplicates are the feature, not a refinement of it.** Re-importing an
overlapping date range is normal use.

* **OFX and QFX** carry your bank's own identifier for each transaction, so an
  exact re-import creates nothing.
* **CSV** carries no such identifier, so its rows are matched against what is
  already in the book on date, amount and description.
* **Every suspected duplicate arrives unticked, with the row it collided with
  shown.** Nothing is dropped quietly. In a financial record, silent
  deduplication and data loss look identical from the outside.

**Your statement is never stored.** A bank statement is the most sensitive
document myClerkBook will ever handle: an account holder, an account number, a
balance and every party you transacted with, most of which the product has no
use for. So the file is read while your request is being served and discarded
when it ends. It is never written to storage, never sent to any model, and no
third party sees it. What survives is a short record that an import happened,
holding the file name, a fingerprint, the period covered and three row counts.

<Note>
  **A CSV goes through whichever door you choose.** Uploaded at **Upload** it is
  treated as a document and read against your daily parse allowance. Imported
  at **Import** it is treated as a statement and charged to your monthly import
  allowance. myClerkBook does not inspect the file to guess which you meant: a
  CSV of one invoice's line items and a CSV of a year's banking are
  indistinguishable to a guess and completely different to you.
</Note>

## Related features

<CardGroup cols={2}>
  <Card title="Integrations" icon="plug" href="/features/integrations">
    Connect a mailbox for email parsing, or your own model key for the Agent.
  </Card>

  <Card title="Plans compared" icon="table-columns" href="/plans-and-billing/plans-compared">
    Parse allowances, import allowances and the Agent add-on, side by side.
  </Card>
</CardGroup>

<Card title="Next: Smart Insights" icon="arrow-right" href="/features/smart-insights">
  Alerts and summaries that reach you without a login.
</Card>
