Introduction
Work with your Helvetly workspace from your own scripts, integrations and AI assistants.
Helvetly has a REST API and an MCP server. Both act as you, in one workspace, with your role and permissions: anything a token does, you could have done in the app yourself.
Quickstart
Create a token and make your first request in two minutes.
Connect an AI assistant
Give Claude, Cursor or any MCP client access to your clients, invoices and figures.
Authentication
Tokens, scopes, expiry and how your role applies.
API reference
Every operation with its parameters, request body, responses and code samples.
What you can do
| Area | Read | Write |
|---|---|---|
| Clients | List and get clients | Create and update clients |
| Invoices | List and get invoices, their payments | Create drafts, issue them, record payments |
| Expenses | List and get expenses | |
| Documents | List and get document metadata | |
| Engagements | List and get engagements | |
| Products | List products | |
| Reports | Key figures |
Everything else (members, billing, settings, your account and the tokens themselves) stays in the app: an API token cannot reach it.
Base URL
All requests go to your Helvetly address, https://app.helvetly.com, under /api/v1. The machine-readable
description of the API is public at https://app.helvetly.com/api/v1/openapi.json.