MCP server
Hobok MCP by usefulapi
Read invoices, customers and products; issue invoices and record payments in Hobok.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://hobok.usefulapi.io/mcpInstall 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