# Bills AI

> Bills AI is a freemium MCP server for finance and payments. Convert bank statement PDFs to CSV and read saved transactions, read-only. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, iOS
- **Website:** https://billsai.cc/mcp
- **MCP Registry name:** cc.billsai/billsai
- **Categories:** finance and payments, files and documents
- **Listing updated:** 2026-11-14

## About

Sign-in uses OAuth 2.1, and any Bills AI account can connect, free ones included; paid plans can instead send an API key as a Bearer token. Two tools handle conversion: one takes a text-layer PDF as base64 (up to 2 MB), and one creates a ten-minute upload link for files up to 10 MB so the PDF never passes through the conversation. The PDF is read in memory and not stored. Scanned or password-protected PDFs are not supported.

The other four tools read what you already saved: statements with bank, date and a financial health grade, transactions with category and a necessary-spending flag, spending summaries by year or month, and CSV exports of up to 1,000 rows a page. Values are copied as printed, so the maintainers advise checking rows against the original statement.

Limits are 10 conversions a minute and 40 a day per account, and 120 other calls a minute. The server cannot add, edit or delete anything. The OAuth token is stored hashed, lasts 90 days and can be revoked in Settings.

## Features

- **PDF to CSV:** Converts a text-layer statement into the transaction table as printed.
- **One-time upload link:** Lets a client PUT a PDF of up to 10 MB without routing it through chat.
- **Saved statement list:** Shows bank, date, status, transaction count and health grade.
- **Transaction filters:** Filters by statement, year, month, category or text, newest first.
- **Spending summary:** Totals income, expenses and per-category amounts.
- **CSV export:** Exports saved transactions with spreadsheet formula protection.

## Good for

- Turn a statement PDF into a spreadsheet-ready CSV
- Ask what you spent by category last month
- Find recurring subscription charges
- Export a category of transactions for bookkeeping

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http billsai https://billsai.cc/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://billsai.cc/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "billsai": {
      "url": "https://billsai.cc/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "billsai": {
      "type": "http",
      "url": "https://billsai.cc/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "billsai": {
      "serverUrl": "https://billsai.cc/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "billsai": {
      "type": "http",
      "url": "https://billsai.cc/api/mcp"
    }
  }
}
```

## Tools

- `convert_statement_pdf`: Converts a text-layer bank statement PDF to CSV.
- `create_statement_upload_url`: Creates a one-time upload link for a PDF up to 10 MB.
- `list_statements`: Lists saved statements in the signed-in account.
- `list_transactions`: Returns saved transactions with filters and paging.
- `get_spending_summary`: Summarises income and spending by category for a period.
- `export_transactions_csv`: Exports saved transactions as CSV text.

## FAQ

### Is my PDF stored?

No. It is read in memory and the CSV goes back to the assistant.

### Can the assistant change my data?

No. All six tools are read-only.

### Does it work on scanned statements?

No. Only text-layer PDFs are supported, and password-protected files are refused.

### Do I need a paid plan?

No. Any Bills AI account can connect with OAuth; API-key access is for paid plans.

### Is Bills AI free?

Bills AI has a free plan, with paid plans for more usage or features.

### How do I add Bills AI to Claude Code?

Run this command in your terminal: claude mcp add --transport http billsai https://billsai.cc/api/mcp

### What are the best alternatives to Bills AI?

The closest alternatives to Bills AI are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, ASTra and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/bills-ai
