# Hobok MCP by usefulapi

> Hobok MCP by usefulapi is an MCP server. Read invoices, customers and products; issue invoices and record payments in Hobok. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read invoices, customers and products; issue invoices and record payments in Hobok.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `hobok_get_me`: Show the hobby business this API key is bound to, the plan, the next invoice number, the payment terms and the currency. GET /v1/me.
- `hobok_list_payment_methods`: List the payment method values that hobok_mark_invoice_paid accepts. Each value is in Swedish and is printed on the receipt. GET /v1/payment-methods.
- `hobok_list_invoices`: List invoices, optionally by status (sent, paid, credited). Each invoice has its number, buyer, lines, totals and dates. GET /v1/invoices.
- `hobok_get_invoice`: Fetch one invoice with its lines, totals, status and emails sent. GET /v1/invoices/{local_id}.
- `hobok_create_invoice`: Issue an invoice with status sent. It takes the next invoice number, which cannot be reused. Give client_id for a saved customer, or buyer for a one-off buyer, not both. VAT is always 0. The invoice is emailed only when send_email is true. POST /v1/invoices with an Idempotency-Key. Retrying the same request with the same key does not issue a second invoice. Two separate invoices with the same cont
- `hobok_mark_invoice_paid`: Record that a sent invoice was paid. Hobok creates the receipt and books the income for the year. Only a sent invoice can be marked paid; any other status returns 409. POST /v1/invoices/{local_id}/mark-paid with an Idempotency-Key. Use hobok_list_payment_methods for payment_method values. A network or timeout error does not say whether the record was saved: list the records first before you retry.
- `hobok_email_receipt`: Queue the payment receipt of a paid invoice for delivery to the buyer. A 200 means queued, not delivered. The API has no idempotency key here: a retry can send the receipt twice, so check hobok_get_invoice first. POST /v1/invoices/{local_id}/receipt/email.
- `hobok_list_clients`: List the saved customers of the hobby business. Use an id from this list as client_id in hobok_create_invoice. GET /v1/clients.
- `hobok_create_client`: Add a saved customer with a name and optional address and contact fields. POST /v1/clients. Hobok documents no idempotency key here. A network or timeout error does not say whether the record was saved: list the records first before you retry.
- `hobok_list_products`: List the saved products and services of the hobby business, with their prices. GET /v1/products.
- `hobok_create_product`: Add a saved product or service with its price in SEK. POST /v1/products. Hobok documents no idempotency key here. A network or timeout error does not say whether the record was saved: list the records first before you retry.

## FAQ

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

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

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