# billey MCP by usefulapi

> billey MCP by usefulapi is a freemium MCP server for accounting and tax. Hosted MCP server that lets AI assistants read your billey invoices, expenses and time. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/billey/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/billey
- **MCP Registry name:** io.usefulapi/billey
- **Categories:** accounting and tax
- **Listing updated:** 2026-11-18

## About

The README describes a hosted connector that links an AI client to a billey bookkeeping account, so questions about invoices, expenses, bank transactions and logged hours can be answered in a chat. Nothing is installed locally; the client is pointed at a single remote URL and signs in through a login page.

Access is read-only. The eleven data tools cover clients, invoices, quotes, expenses, vendors, bank transactions, products, projects and time entries, and list calls use cursor pagination with an updated_after filter for syncing changes. Authentication uses a billey personal access token created in the account's API token settings, with two-factor authentication required.

The server is aimed at freelancers and small companies that keep their books in billey. It is an independent service run by usefulapi and is not affiliated with billey.

## Features

- **Read-only billey data:** All eleven data tools only read clients, invoices, expenses and related records from the account.
- **Hosted remote endpoint:** Connects over Streamable HTTP with OAuth login, so no local install is needed.
- **Cursor pagination and sync:** List tools return paged results and accept updated_after to fetch only recent changes.
- **Bank transaction review:** Lists imported bank transactions with amount, counterparty and match state.
- **Project hour tracking:** Lists projects and their time entries with hours, hourly rate and date.

## Good for

- Asking which invoices are unpaid and how many days overdue they are
- Reviewing expenses and their VAT amounts for a given month
- Finding bank transactions that still need matching
- Checking hours logged against a project
- Syncing changed client records into another tool

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http billey https://billey.usefulapi.io/mcp
```

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

```sh
https://billey.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "billey": {
      "url": "https://billey.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "billey": {
      "type": "http",
      "url": "https://billey.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "billey": {
      "serverUrl": "https://billey.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "billey": {
      "type": "http",
      "url": "https://billey.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `billey_list_clients`: List the clients of the book (name, contact, payment terms, collection method).
- `billey_get_client`: Get one client by id, with its contact and payment details.
- `billey_list_invoices`: List invoices with status, dates, totals, the client summary and line items.
- `billey_get_invoice`: Get one invoice by id, with its client summary and line items.
- `billey_list_quotes`: List quotes (offers) with status, dates, totals and line items.
- `billey_list_expenses`: List expenses (purchase costs) with amounts, dates, the vendor summary and the account.
- `billey_list_vendors`: List vendors (suppliers) with their contact and payment details.
- `billey_list_bank_transactions`: List imported bank transactions (amount, executed date, counterparty, match and allocation state).
- `billey_list_products`: List products and services from the book's catalogue (unit price, VAT percentage, SKU).
- `billey_list_projects`: List projects with their client summary.
- `billey_list_time_entries`: List logged time entries (hours and hourly rate as decimal strings, date, project).

## FAQ

### Is this an official billey product?

No. The site says usefulapi is an independent service and is not affiliated with or endorsed by billey.

### Can the AI change my billey data?

All 11 billey data tools are marked read-only.

### What do I need to connect?

The login page asks for a billey personal access token, created under your book's Settings → API tokens with two-factor authentication on.

### What does it cost?

The free plan allows 50 tool calls a month. Pro is $9/mo or $90/yr for 10,000 calls, and Pro+ is $39/mo or $390/yr for 100,000 calls, each covering this server only.

### Is billey MCP by usefulapi free?

billey MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add billey MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http billey https://billey.usefulapi.io/mcp

### What are the best alternatives to billey MCP by usefulapi?

The closest alternatives to billey MCP by usefulapi are Fatture in Cloud MCP by usefulapi, KashFlow MCP by usefulapi, CBO MCP by usefulapi, Facture App MCP by usefulapi and FiscalHub MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Fatture in Cloud MCP by usefulapi](https://ai-powered.com/mcp/fatture-in-cloud-mcp-by-usefulapi): Fatture in Cloud MCP by usefulapi is a freemium MCP server for accounting and tax.
- [KashFlow MCP by usefulapi](https://ai-powered.com/mcp/kashflow-mcp-by-usefulapi): KashFlow MCP by usefulapi is a freemium MCP server for accounting and tax.
- [CBO MCP by usefulapi](https://ai-powered.com/mcp/cbo-mcp-by-usefulapi): CBO MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Facture App MCP by usefulapi](https://ai-powered.com/mcp/facture-app-mcp-by-usefulapi): Facture App MCP by usefulapi is a freemium MCP server for finance and payments.
- [FiscalHub MCP by usefulapi](https://ai-powered.com/mcp/fiscalhub-mcp-by-usefulapi): FiscalHub MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Doklado MCP by usefulapi](https://ai-powered.com/mcp/doklado-mcp-by-usefulapi): Doklado MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Collmex MCP by usefulapi](https://ai-powered.com/mcp/collmex-mcp-by-usefulapi): Collmex MCP by usefulapi is a freemium MCP server for accounting and tax.
- [Invoices Online MCP by usefulapi](https://ai-powered.com/mcp/invoices-online-mcp-by-usefulapi): Invoices Online MCP by usefulapi is a freemium MCP server for accounting and tax.

---
Source: https://ai-powered.com/mcp/billey-mcp-by-usefulapi
