# Bukku MCP by usefulapi

> Bukku MCP by usefulapi is an MCP server. Read Bukku contacts, accounts, invoices, bills and journals; create contacts and sales invoices. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/bukku/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/bukku
- **MCP Registry name:** io.usefulapi/bukku
- **Listing updated:** 2026-11-13

## About

Read Bukku contacts, accounts, invoices, bills and journals; create contacts and sales invoices.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `bukku_list_contacts`: List contacts (customers, suppliers, employees) with name, code, type, receivable and payable balances. Search matches the name, receivable, payable and created date. GET /contacts.
- `bukku_get_contact`: One contact with its persons, addresses, tax and registration numbers, default accounts and credit limit. GET /contacts/{id}.
- `bukku_list_contact_groups`: List the contact groups; use their ids to filter bukku_list_contacts. GET /contacts/groups.
- `bukku_list_accounts`: List ledger accounts from the chart of accounts, optionally by category. Account ids are used on invoice lines. GET /accounts.
- `bukku_get_account`: One ledger account by id. GET /accounts/{id}.
- `bukku_list_products`: List products and bundles (sales and purchase details, SKU, stock). GET /products.
- `bukku_get_product`: One product with its units, prices, accounts and tax settings. GET /products/{id}.
- `bukku_list_product_groups`: List the product groups. GET /products/groups.
- `bukku_list_sales_invoices`: List sales invoices with number, date, contact, amount, balance and payment status. Filter by date, customer, payment status (PAID, OUTSTANDING, OVERDUE) or keywords. GET /sales/invoices.
- `bukku_list_sales_documents`: List quotes, sales orders, delivery orders, credit notes, customer payments or refunds (invoices have their own tool, bukku_list_sales_invoices). payment_status applies to credit notes, payments and refunds only. GET /sales/{quotes|orders|delivery_orders|credit_notes|payments|refunds}.
- `bukku_get_sales_document`: One sales document in full (lines, taxes, terms, payments, status): an invoice, quote, order, delivery order, credit note, payment or refund. GET /sales/{type}/{id}.
- `bukku_list_purchase_bills`: List purchase bills with number, date, supplier, amount, balance and payment status. Filter by date, supplier, payment status (PAID, OUTSTANDING, OVERDUE) or keywords. GET /purchases/bills.
- `bukku_list_purchase_documents`: List purchase orders, goods received notes, supplier credit notes, supplier payments or refunds (bills have their own tool, bukku_list_purchase_bills). payment_status applies to credit notes, payments and refunds only. GET /purchases/{orders|goods_received_notes|credit_notes|payments|refunds}.
- `bukku_get_purchase_document`: One purchase document in full (lines, taxes, terms, payments, status): a bill, order, goods received note, credit note, payment or refund. GET /purchases/{type}/{id}.
- `bukku_list_journal_entries`: List manual journal entries by date, status or keywords. GET /journal_entries.
- `bukku_get_journal_entry`: One journal entry with its debit and credit lines. GET /journal_entries/{id}.
- `bukku_list_bank_transactions`: List banking transactions: money in (incomes), money out (expenses) or transfers between accounts. contact_id and sort_by do not apply to transfers. GET /banking/{incomes|expenses|transfers}.
- `bukku_get_bank_transaction`: One money in, money out or transfer transaction in full. GET /banking/{incomes|expenses|transfers}/{id}.
- `bukku_list_tags`: List the tags (labels) that can be put on transactions. GET /tags.
- `bukku_get_lookup_lists`: Reference data needed to fill in documents: tax codes, payment terms, payment methods, currencies, countries, accounts, contact groups, product groups, price levels, tag groups, number formats, custom fields and company settings. Read-only (POST /v2/lists is a read endpoint).
- `bukku_create_contact`: WRITE: create a contact (customer, supplier and/or employee) in Bukku. The contact code must be unique (A-Z, 0-9, _ and -, max 15 characters). POST /contacts.
- `bukku_set_contact_archived`: WRITE: archive (is_archived true) or restore (false) a contact. Archiving hides it from active lists; nothing is deleted. PATCH /contacts/{id}.
- `bukku_create_sales_invoice`: WRITE: create a sales invoice for a customer. status defaults to draft (nothing posted to the ledger), status ready finalizes it and affects the books. payment_mode credit needs term_items, cash needs deposit_items. Companies with MyInvois submission switched on must pass myinvois_action when status is ready: NORMAL (not sent), EXTERNAL (already validated elsewhere) or VALIDATE (submits the invoic

## FAQ

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

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

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