Skip to content
MCP server

billey MCP by usefulapi

Hosted MCP server that lets AI assistants read your billey invoices, expenses and time

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.7.1
Listing updated
today

About billey MCP by usefulapi

billey MCP by usefulapi is a freemium MCP server for accounting and tax. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://billey.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "billey": {
      "url": "https://billey.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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).

What it does

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

Pricing

Freemium, from $9 a month

Free plan with 50 tool calls/month; Pro from $9/mo or $90/yr; Pro+ from $39/mo.

Prices change. Check usefulapi.io before you buy.

billey MCP by usefulapi 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.

How AIPoweredBot checks servers

Alternatives to billey MCP by usefulapi

  1. Hosted MCP server connecting Fatture in Cloud invoicing to Claude, ChatGPT and Cursor

    Not checked yet
    • 23 tools
    • Remote
    • Freemium
    • Accounting and tax
  2. Hosted MCP server connecting KashFlow invoices, banking and reports to AI assistants

    Not checked yet
    • 38 tools
    • Remote
    • Freemium
    • Accounting and tax
  3. Hosted MCP server connecting AI assistants to CBO invoices, orders, clients and products

    Not checked yet
    • 30 tools
    • Remote
    • Freemium
    • Accounting and tax
  4. Hosted MCP server to stamp, cancel and list CFDI invoices in Facture App for Mexican

    Not checked yet
    • 10 tools
    • Remote
    • Freemium
    • Finance and payments
  5. Hosted MCP server for Brazilian NF-e and NFC-e tax documents and NCM lookups in FiscalHub

    Not checked yet
    • 9 tools
    • Remote
    • Freemium
    • Accounting and tax
  6. Hosted MCP connector that lets AI assistants read and update Doklado accounting documents

    Not checked yet
    • 9 tools
    • Remote
    • Freemium
    • Accounting and tax