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

# Security & data access

> What ClearSpend AI can and cannot do with your connected accounts, what data is stored, and how it is protected.

ClearSpend AI connects to your bank accounts, accounting tools, email, and calendar to surface spend automatically. This page explains exactly what access is requested, what data is stored, and what ClearSpend AI is **not** permitted to do.

## Permissions at a glance

Each connection asks only for what it needs. Only Xero and QuickBooks can change data — everything else is read-only.

| Connection | Reads your data? | Changes your data? |
| - | - | - |
| Gmail | Yes, emails | No |
| Google Drive | Yes, files | No |
| Google Workspace | Yes, users and logs | No |
| Plaid (bank) | Yes, transactions | No, and it can't move money |
| Xero | Yes | Yes, only when you push |
| QuickBooks | Yes | Yes, only when you push |

***

## Plaid (bank & card accounts)

**Reads your transactions. It cannot move money.**

Plaid is used to import transactions from your bank or corporate card feed. The connection is read-only — ClearSpend AI reads your transaction data and nothing else.

**What is read:**

* Transaction history: vendor, amount, date, and category
* Account balances and account metadata

**What ClearSpend AI cannot do:**

* Initiate or approve any payment or transfer
* Delete, modify, or archive any transaction in your bank
* See your login credentials — Plaid authenticates directly with your bank; ClearSpend AI never touches your password

There is no way for ClearSpend AI to move money through Plaid. The integration has no write access of any kind.

***

## Xero

**Reads your data. Changes your data only when you push.**

Xero is connected to import existing spend data and to push reconciled charges back. Any change to your Xero data only happens when you explicitly trigger a push — nothing is written automatically.

**What is read:**

* Transactions, invoices, accounts, and contacts

**What is written (only when you push):**

* New SPEND bank transactions created from your reconciled charges
* Invoice and receipt files attached to existing transactions

**What ClearSpend AI cannot do:**

* Delete any existing transaction, invoice, or contact in Xero
* Modify or overwrite any existing transaction's amount, date, or vendor
* Create duplicate transactions — existing matches are checked before anything is created

***

## QuickBooks

**Reads your data. Changes your data only when you push.**

QuickBooks is connected to import existing spend data and to push reconciled charges back. Any change to your QuickBooks data only happens when you explicitly trigger a push — nothing is written automatically.

**What is read:**

* Transactions, bills, vendors, and accounts

**What is written (only when you push):**

* New Purchase transactions created from your reconciled charges
* Invoice and receipt files attached to existing transactions

**What ClearSpend AI cannot do:**

* Delete any existing transaction, bill, or vendor in QuickBooks
* Modify or overwrite any existing transaction's amount, date, or vendor
* Create duplicate transactions — existing matches are checked before anything is created

***

## Gmail

**Read-only access, limited to billing emails only. Nothing is ever sent, deleted, or modified.**

ClearSpend AI does not have access to your full inbox. Before fetching any email, it runs a filter against Gmail's search API. An email is only retrieved if it passes **all three** of the following conditions simultaneously:

1. **Subject keyword match** — the subject line must contain at least one of these exact words: `invoice`, `invoices`, `receipt`, `receipts`, `payment`, `payments`, `bill`, `bills`
2. **Has an attachment** — emails with no attached file are skipped entirely
3. **Not in Sent or Drafts** — only received emails are considered

If an email fails any one of those three conditions it is never fetched — not even its subject line is read. Emails about anything other than billing (newsletters, conversations, notifications, etc.) are never touched.

From the emails that do pass the filter, ClearSpend AI reads the subject line, sender name, and the attached file (invoice or receipt). That file is extracted and stored. The body text of the email is not stored.

***

## Google Drive

**Read-only access, limited to a single folder you choose. Only PDF files are imported.**

When you connect Google Drive, you are shown a folder picker (Google Picker). ClearSpend AI only ever accesses the folder you select at that point — it does not browse or scan any other part of your Drive.

Within that folder (and any subfolders inside it), ClearSpend AI imports only **PDF files**. All other file types — spreadsheets, Docs, images, videos, anything that is not a PDF — are ignored completely.

ClearSpend AI cannot create, edit, move, rename, or delete any file in your Drive. Access is strictly read-only.

***

## Google Workspace

**Reads your users and logs. Changes nothing.**

Google Workspace is connected to track software usage signals (logins and app activity) for subscription management.

**What is read:**

* User login events and app usage activity from the Admin SDK
* The list of users and their assigned apps

**What ClearSpend AI cannot do:**

* Create, delete, or suspend users
* Change any app permissions or organization-wide settings
* Access email content or Drive files via the Workspace connection

***

## Slack

Slack is connected to send notifications — renewal reminders, invoice requests, and monthly spend digests.

**What ClearSpend AI can do:**

* Post messages to channels and DMs that you configure
* Read channel names and member lists to allow you to choose notification destinations

**What ClearSpend AI cannot do:**

* Read message history in your Slack workspace
* Post to channels you have not configured
* Access files or private channels

***

## Chrome extension

The Chrome extension tracks which SaaS tools your team actively uses by detecting visited domains.

**What ClearSpend AI can do:**

* Detect when a browser tab visits a domain that matches a known SaaS product
* Send that usage signal (domain + timestamp) to ClearSpend AI

**What ClearSpend AI cannot do:**

* Read page content, form inputs, or passwords
* Track any domain outside the ClearSpend AI SaaS product list
* Run when the browser is closed

The extension requires explicit installation by each user. It does not run silently in the background.

***

## Data storage

**What is stored:**

* Transaction metadata: vendor name, amount, date, category, and GL code
* Invoice and receipt files you upload or that are detected via email
* Usage signals from the Chrome extension and Google Workspace
* Subscription details you create or that are inferred from spend

**What is not stored:**

* Your bank login credentials (Plaid handles authentication directly)
* Raw email content beyond the extracted invoice/receipt data
* Google Drive file contents beyond the extracted documents

***

## Revoking access

You can disconnect any integration at any time from **Settings → Integrations**. Disconnecting removes ClearSpend AI's access tokens immediately. Existing imported data remains in your workspace until you delete it.

To delete your workspace and all associated data, contact support.

***

## Encryption & infrastructure

All data is encrypted in transit. ClearSpend AI is hosted on \[Fly.io / AWS — confirm].

***

## Support & reporting security issues

If you discover a security vulnerability or have questions about data handling, contact us at **[support@clearspend.ai](mailto:support@clearspend.ai)**. We respond within **12 hours**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.