Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Nutshell

Scalekit connector
Open markdown

The Nutshell connector lets your AI agent act in each user's Nutshell account. Each user connects their own Nutshell 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
37 · 17 · 637 read17 write6 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 Nutshell connection

    In AgentKit > Connections, create a Nutshell 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
  • nutshell_account_getGet one account (company) by ID.Read-only

    Get Account

    Get one account (company) by ID. Returns the account with contact info, industry, owners, tags, linked contacts and leads. Use this when you know the ID.

    Inputs

    idstringrequired
    Nutshell API ID of the account, in the form <number>-accounts. Example: 337-accounts.
  • nutshell_account_types_listList account types.Read-only

    List Account Types

    List account types. Returns account types with id and name. Use this for an account's accountType link.

    Inputs

    This tool takes no inputs.

  • nutshell_accounts_listList accounts (companies) in Nutshell, optionally searched by name and sorted.Read-only

    List Accounts

    List accounts (companies) in Nutshell, optionally searched by name and sorted. Returns accounts with id, name, description, owners, emails, phones, urls, addresses and links, plus meta paging. Use this to find a company. Use nutshell_account_get for one account.

    Inputs

    pageinteger
    Page number, starting at 0. Example: 0.
    page_limitinteger
    Results per page (default 50). Example: 25.
    qstring
    Search text matched against account names. Example: Acme.
    sortstring
    Field to sort by; prefix with - for descending. Example: -modifiedTime.
  • nutshell_activities_listList activities (calls, meetings, emails logged as activities), filtered by status, type, flag or date range.Read-only

    List Activities

    List activities (calls, meetings, emails logged as activities), filtered by status, type, flag or date range. Returns activities with id, name, activityType, startTime, endTime, status, participants and leads. Use this to see scheduled or logged activities. Use nutshell_activity_get for one.

    Inputs

    activity_typearray
    Activity type IDs from nutshell_activity_types_list. Example: ["1-activityTypes"]
    date_maxstring
    Latest start date (YYYY-MM-DD). Example: 2026-01-31.
    date_minstring
    Earliest start date (YYYY-MM-DD). Example: 2026-01-01.
    flaggedboolean
    Only flagged activities. Example: true.
    limitinteger
    Maximum number of results. Example: 25.
    participantarray
    Participant IDs (users or contacts). Example: ["3-contacts"]
    qstring
    Search text matched against activity names. Example: Acme.
    statusarray
    Statuses to include (e.g. scheduled, logged, overdue, cancelled). Example: ["scheduled"]
  • nutshell_activity_getGet one activity by ID.Read-only

    Get Activity

    Get one activity by ID. Returns the activity with type, times, agenda, note, participants and leads. Use this when you know the ID.

    Inputs

    idstringrequired
    Nutshell API ID of the activity, in the form <number>-activities. Example: 12-activities.
  • nutshell_activity_types_listList activity types.Read-only

    List Activity Types

    List activity types. Returns activity types with id and name. Use this to pick activity_type for nutshell_activity_create.

    Inputs

    This tool takes no inputs.

  • nutshell_audiences_listList email marketing audiences.Read-only

    List Audiences

    List email marketing audiences. Returns audiences with id, name and member counts. Use this to review marketing lists.

    Inputs

    This tool takes no inputs.

  • nutshell_competitors_listList competitors.Read-only

    List Competitors

    List competitors. Returns competitors with id and name. Use this to record competitors on leads.

    Inputs

    This tool takes no inputs.