Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Kintone

Scalekit connector
Open markdown

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

Tools
33
What they doRead · write · destructive
20 · 10 · 320 read10 write3 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 Kintone connection

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

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'kintone'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Kintone:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'kintone_app_actions_get',
    toolInput: { app: 10 },
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Kintone credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • kintone_app_actions_getGet a Kintone app's action settings (buttons that copy a record into another app).Read-only

    Get Action Settings

    Get a Kintone app's action settings (buttons that copy a record into another app). Returns each action with its destination app, field mappings and who can use it. Use it to understand cross-app record copying. Use kintone_app_process_management_get for workflow actions.

    Inputs

    appintegerrequired
    ID of the Kintone app. It is the number after /k/ in the app's URL, for example 42 in https://mycompany.kintone.com/k/42/. The connection's API token must belong to this app. Example: 42.
    langstring
    Language for localized names in the response: default (names as entered), en, zh, ja, or user (the authenticating user's language). Kintone returns default names if left empty. Example: "en".one of defaultenzhjauser
  • kintone_app_admin_notes_getGet a Kintone app's admin notes.Read-only

    Get App Admin Notes

    Get a Kintone app's admin notes. Returns the notes HTML content, whether they are copied into app templates and duplicates, and the revision. Use it to read the app manager's documentation for the app.

    Inputs

    appintegerrequired
    ID of the Kintone app. It is the number after /k/ in the app's URL, for example 42 in https://mycompany.kintone.com/k/42/. The connection's API token must belong to this app. Example: 42.
  • kintone_app_field_permissions_getGet a Kintone app's field permission rules.Read-only

    Get Field Permissions

    Get a Kintone app's field permission rules. Returns each restricted field code with the users, groups or departments and their access level (READ, WRITE or NONE). Use it to check why a field is hidden or read-only. Use kintone_app_record_permissions_get for record-level rules.

    Inputs

    appintegerrequired
    ID of the Kintone app. It is the number after /k/ in the app's URL, for example 42 in https://mycompany.kintone.com/k/42/. The connection's API token must belong to this app. Example: 42.
  • kintone_app_form_fields_getGet the fields of a Kintone app's form.Read-only

    Get Form Fields

    Get the fields of a Kintone app's form. Returns each field keyed by field code with its type, label, required flag, options, default value and lookup settings. Use it before reading or writing records to learn field codes and value formats. Use kintone_app_form_layout_get for field placement.

    Inputs

    appintegerrequired
    ID of the Kintone app. It is the number after /k/ in the app's URL, for example 42 in https://mycompany.kintone.com/k/42/. The connection's API token must belong to this app. Example: 42.
    langstring
    Language for localized names in the response: default (names as entered), en, zh, ja, or user (the authenticating user's language). Kintone returns default names if left empty. Example: "en".one of defaultenzhjauser
  • kintone_app_form_layout_getGet the layout of a Kintone app's form.Read-only

    Get Form Layout

    Get the layout of a Kintone app's form. Returns rows, tables and groups with the field codes and sizes they contain. Use it to see how fields are arranged. Use kintone_app_form_fields_get for field types and options.

    Inputs

    appintegerrequired
    ID of the Kintone app. It is the number after /k/ in the app's URL, for example 42 in https://mycompany.kintone.com/k/42/. The connection's API token must belong to this app. Example: 42.
  • kintone_app_general_notifications_getGet a Kintone app's general notification settings.Read-only

    Get General Notification Settings

    Get a Kintone app's general notification settings. Returns who is notified when records are added, edited, commented on, change status or are imported, and whether commenters are notified. Use it for app-wide notifications. Use kintone_app_per_record_notifications_get and kintone_app_reminder_notifications_get for conditional ones.

    Inputs

    appintegerrequired
    ID of the Kintone app. It is the number after /k/ in the app's URL, for example 42 in https://mycompany.kintone.com/k/42/. The connection's API token must belong to this app. Example: 42.
  • kintone_app_getGet a Kintone app's general information.Read-only

    Get App

    Get a Kintone app's general information. Returns the app id, code, name, description, space and thread ids, and creator and modifier details. Use it to confirm which app an ID points to. Use kintone_app_form_fields_get for its fields.

    Inputs

    idintegerrequired
    ID of the Kintone app. It is the number after /k/ in the app's URL, for example 42 in https://mycompany.kintone.com/k/42/. The connection's API token must belong to this app. Example: 42.
  • kintone_app_graphs_getGet the graph (chart) settings of a Kintone app.Read-only

    Get Graph Settings

    Get the graph (chart) settings of a Kintone app. Returns each graph keyed by name with its chart type, groups, aggregations, filter condition and sort. Use it to understand saved reports. Use kintone_app_views_get for list views.

    Inputs

    appintegerrequired
    ID of the Kintone app. It is the number after /k/ in the app's URL, for example 42 in https://mycompany.kintone.com/k/42/. The connection's API token must belong to this app. Example: 42.
    langstring
    Language for localized names in the response: default (names as entered), en, zh, ja, or user (the authenticating user's language). Kintone returns default names if left empty. Example: "en".one of defaultenzhjauser