# Thourum Billy MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.thourum%2Fbilly-mcp
Registry id: `mcp-registry/io.github.thourum/billy-mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "thourum-billy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "billy-mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add thourum-billy-mcp-server -- npx -y billy-mcp
```

## Tools (40)

- `approve_invoice`: Approve an invoice
- `attach_file`: Attach a file to an invoice, bill, or journal entry
- `batch_void_daybook_transactions`: Void multiple daybook transactions in one batch with one approval
- `billy_raw_request`: Make a raw request to any Billy v2 API endpoint
- `create_bank_payment`: Create a bank payment to mark invoices/bills paid
- `create_bill`: Create a new bill
- `create_contact`: Create a new contact
- `create_contact_person`: Create a contact person
- `create_daybook_transaction`: Create a journal entry (daybook transaction) with debit/credit validation
- `create_invoice`: Create an invoice with embedded lines, optionally approve immediately
- `create_product`: Create a new product
- `delete_invoice`: Delete an invoice
- `execute_script`: Run a sandboxed JavaScript batch script with mutation log and dry-run support
- `get_account`: Get an account by ID
- `get_account_balances`: Get trial balance or per-account balance from postings
- `get_bill`: Get a bill by ID
- `get_contact`: Get a contact by ID
- `get_invoice`: Get an invoice by ID
- `get_organization`: Get organization details
- `get_product`: Get a product by ID
- `list_accounts`: List accounts
- `list_attachments`: List attachments
- `list_balance_modifiers`: List balance modifiers
- `list_bank_line_matches`: List bank line matches
- `list_bank_lines`: List bank lines
- `list_bank_payments`: List bank payments
- `list_bills`: List bills (expenses)
- `list_contact_persons`: List contact persons
- `list_contacts`: List contacts
- `list_daybook_transactions`: List daybook transactions
- `list_daybooks`: List daybooks
- `list_files`: List files
- `list_invoices`: List invoices
- `list_postings`: List postings
- `list_products`: List products
- `list_transactions`: List transactions
- `update_contact`: Update an existing contact
- `update_product`: Update an existing product
- `upload_file`: Upload a file (pdf/jpg/png/gif)
- `void_daybook_transaction`: Void a daybook transaction

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.