Skip to content
MCP server

Hobok MCP by usefulapi

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

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About Hobok MCP by usefulapi

Hobok MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hobok": {
      "url": "https://hobok.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": {
    "hobok": {
      "type": "http",
      "url": "https://hobok.usefulapi.io/mcp"
    }
  }
}

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

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

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

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

Tools this server provides (11)

Read directly from the server.

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.

Hobok MCP by usefulapi 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