Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Quaderno

Scalekit connector
Open markdown

The Quaderno connector lets your AI agent act in each user's Quaderno account. Each user connects their own Quaderno API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
28 · 23 · 928 read23 write9 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Quaderno connection

    In AgentKit > Connections, create a Quaderno connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • quaderno_contact_getGet one contact by ID.Read-only

    Get Contact

    Get one contact by ID. Returns kind, names, email, full address, tax ID, tax status, language, discount, processor IDs and billing area permalink.

    Inputs

    idstringrequired
    ID of the contact. Example: 123456.
  • quaderno_contacts_listList customers and vendors (contacts), newest first, optionally filtered by name, email or tax ID text, or by payment processor ID.Read-only

    List Contacts

    List customers and vendors (contacts), newest first, optionally filtered by name, email or tax ID text, or by payment processor ID. Returns per contact its ID, kind, name, email, address, tax ID, tax status and processor IDs. Use this to find a contact. Use quaderno_contact_get for one contact.

    Inputs

    created_beforeinteger
    Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
    limitinteger
    Page size, up to 100 (default 25). Example: 25.
    processor_idstring
    Only records with this payment processor ID. Example: cus_PQ9xY2.
    qstring
    Text to match against the contact's full name, email or tax ID (case-sensitive). Example: Acme.
  • quaderno_credit_getGet one credit note by ID.Read-only

    Get Credit Note

    Get one credit note by ID. Returns number, dates, contact, items, taxes, totals, payments, state and URLs.

    Inputs

    idstringrequired
    ID of the credit note. Example: 123456.
  • quaderno_credits_listList credit notes (refunds), newest first, filtered by text, issue date range, state or processor ID.Read-only

    List Credit Notes

    List credit notes (refunds), newest first, filtered by text, issue date range, state or processor ID. Returns per credit note its ID, number, date, contact, totals, taxes and state.

    Inputs

    created_beforeinteger
    Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
    datestring
    Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-01-01,2026-06-30.
    limitinteger
    Page size, up to 100 (default 25). Example: 25.
    processor_idstring
    Only records with this payment processor ID. Example: cus_PQ9xY2.
    qstring
    Text to match against the credit note number or customer name. Example: Acme.
    statestring
    Filters a credit notes list based on the credit state. One of: outstanding, late, paid. Example: outstanding.one of outstandinglatepaid
  • quaderno_evidence_listList location evidence records, optionally by state or document ID.Read-only

    List Location Evidence

    List location evidence records, optionally by state or document ID. Returns per record the document, billing, IP and bank countries and state.

    Inputs

    document_idinteger
    Only evidence of this invoice ID. Example: 778899.
    statestring
    Evidence state: unsettled, conflicting or confirmed. Example: conflicting.
  • quaderno_expense_getGet one expense by ID.Read-only

    Get Expense

    Get one expense by ID. Returns date, vendor, items, taxes, totals, payments and attachment.

    Inputs

    idstringrequired
    ID of the expense. Example: 123456.
  • quaderno_expenses_listList expenses (purchases), newest first, filtered by text, date range, state or vendor contact.Read-only

    List Expenses

    List expenses (purchases), newest first, filtered by text, date range, state or vendor contact. Returns per expense its ID, date, vendor, totals and taxes.

    Inputs

    contactinteger
    Only expenses of this vendor contact ID. Example: 4321.
    created_beforeinteger
    Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
    datestring
    Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-01-01,2026-06-30.
    limitinteger
    Page size, up to 100 (default 25). Example: 25.
    qstring
    Text to match against the expense subject or vendor name. Example: Acme.
    statestring
    Filters an expenses list based on the expense state: outstanding, late and paid. One of: outstanding, late, paid. Example: outstanding.one of outstandinglatepaid
  • quaderno_invoice_getGet one invoice by ID.Read-only

    Get Invoice

    Get one invoice by ID. Returns its number, dates, contact, items, taxes, totals, payments, state, PDF and permalink URLs.

    Inputs

    idstringrequired
    ID of the invoice. Example: 123456.