billey MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

Read clients, invoices, expenses, bank transactions and time entries in billey.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted read-only MCP access to a billey book: clients, invoices, quotes, expenses, bank transactions, products, projects and time entries.

What you can do
  • List and fetch clients with contact and payment terms
  • List and fetch invoices with status, totals, client summary and line items
  • List quotes, expenses, vendors, bank transactions, products, projects and time entries
  • Check monthly tool-call usage, request a missing feature, upgrade or cancel a plan
When to use it
Useful when you keep your bookkeeping in billey and want an assistant to answer questions about unpaid invoices, expenses, bank transactions or logged project time without exporting data by hand.
Requirements
Remote streamable HTTP endpoint; no local install. Connect with the server URL only and sign in through OAuth, providing a billey personal access token from the book's API token settings (two-factor authentication must be enabled). A free plan allows 50 tool calls per month.
Before you install
The token grants read access to your book's financial and client data, which is sent to the hosted service. Meta tools can start a paid Stripe subscription (Pro or Pro+) or cancel it, so confirm before running them. Free tier is capped at 50 calls per month; Pro has a 10,000-call fair-use limit.

Installation

In SourceWeft

  1. Open billey MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fbilley/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

billey MCP by usefulapi

Use your billey account from Claude, Cursor, or any MCP client. Read the clients, invoices, quotes, expenses, bank transactions and time entries of your book. Hosted, no local install: connect with your own credentials.

Live endpoint: https://billey.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://billey.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http billey https://billey.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "billey": {      "url": "https://billey.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your billey credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/billey/

On first connect you provide a billey personal access token (your book's Settings → API tokens; two-factor authentication must be on). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
billey_list_clientsreadList clients
billey_get_clientreadGet a client
billey_list_invoicesreadList invoices
billey_get_invoicereadGet an invoice
billey_list_quotesreadList quotes
billey_list_expensesreadList expenses
billey_list_vendorsreadList vendors
billey_list_bank_transactionsreadList bank transactions
billey_list_productsreadList products
billey_list_projectsreadList projects
billey_list_time_entriesreadList time entries
billey_usage_statusmetaUsage status (free-tier meter)
billey_request_featuremetaRequest a missing feature
billey_upgrademetaUpgrade to Pro or Pro+
billey_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with billey_upgrade (it returns a Stripe Checkout link). Cancel any time with billey_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running billey_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/billey/README.md at commit 4046075

Tools

11

billey_list_clients

List clients

List the clients of the book (name, contact, payment terms, collection method). Returns cursor pagination: follow links.next. Use updated_after to sync only changes. billey API: GET /api/v1/clients.

Parameterscursorfieldsper_pageupdated_after

billey_get_client

Get a client

Get one client by id, with its contact and payment details. billey API: GET /api/v1/clients/{client}.

Parametersclient_idrequired

billey_list_invoices

List invoices

List invoices with status, dates, totals (decimal strings), the client summary and line items. Filter with updated_after for changes since a time. Returns cursor pagination. billey API: GET /api/v1/invoices.

Parameterscursorfieldsper_pageupdated_after

billey_get_invoice

Get an invoice

Get one invoice by id, with its client summary and line items. billey API: GET /api/v1/invoices/{invoice}.

Parametersinvoice_idrequired

billey_list_quotes

List quotes

List quotes (offers) with status, dates, totals and line items. Returns cursor pagination. billey API: GET /api/v1/quotes (needs the quotes:read ability).

Parameterscursorfieldsper_pageupdated_after

billey_list_expenses

List expenses

List expenses (purchase costs) with amounts, dates, the vendor summary and the account. Returns cursor pagination. billey API: GET /api/v1/expenses.

Parameterscursorfieldsper_pageupdated_after

billey_list_vendors

List vendors

List vendors (suppliers) with their contact and payment details. Returns cursor pagination. billey API: GET /api/v1/vendors.

Parameterscursorfieldsper_pageupdated_after

billey_list_bank_transactions

List bank transactions

List imported bank transactions (amount, executed date, counterparty, match and allocation state). Returns cursor pagination. billey API: GET /api/v1/bank-transactions (needs transactions:read).

Parameterscursorfieldsper_pageupdated_after

billey_list_products

List products

List products and services from the book's catalogue (unit price, VAT percentage, SKU). Returns cursor pagination. billey API: GET /api/v1/products (needs products:read).

Parameterscursorfieldsper_pageupdated_after

billey_list_projects

List projects

List projects with their client summary. Returns cursor pagination. billey API: GET /api/v1/projects (needs projects:read).

Parameterscursorfieldsper_pageupdated_after

billey_list_time_entries

List time entries

List logged time entries (hours and hourly rate as decimal strings, date, project). Returns cursor pagination. billey API: GET /api/v1/time-entries (needs time-entries:read).

Parameterscursorfieldsper_pageupdated_after

Version history

7
  1. v1.3.4LatestNov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026
  7. v1.0.0Nov 1, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026