Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to CalendarHero

Scalekit connector
Open markdown

The CalendarHero connector lets your AI agent act in each user's CalendarHero account. Each user connects their own CalendarHero 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
18 · 11 · 418 read11 write4 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 CalendarHero connection

    In AgentKit > Connections, create a CalendarHero 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 = 'calendarhero'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize CalendarHero:', 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: 'calendarhero_assistant_reply_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their CalendarHero 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
  • calendarhero_assistant_reply_getGet the CalendarHero assistant's latest reply message for the user.Read-only

    Get Assistant Reply

    Get the CalendarHero assistant's latest reply message for the user. Returns the reply text and any options. Use Send Assistant Message first.

    Inputs

    This tool takes no inputs.

  • calendarhero_contact_getGet one contact by ID, with insights unless basic is set.Read-only

    Get Contact

    Get one contact by ID, with insights unless basic is set. Returns the contact's name, emails, phones, title, organization and insights. Use Search Contacts to find the ID.

    Inputs

    contact_idstringrequired
    CalendarHero contact ID, from Search Contacts. Example: 5f3a1b2c4d5e6f7890123456.
    basicboolean
    true returns only the data stored in CalendarHero; false (default) also returns contact insights. Example: true.
  • calendarhero_contacts_countCount the user's contacts.Read-only

    Count Contacts

    Count the user's contacts. Returns the number of contacts. Use Search Contacts to list them.

    Inputs

    This tool takes no inputs.

  • calendarhero_directories_listList the calendars, contact books and other services the user has connected to CalendarHero.Read-only

    List Connected Directories

    List the calendars, contact books and other services the user has connected to CalendarHero. Returns each connection with its id, provider type, category types and import dates. Use Get Connected Directory for one connection.

    Inputs

    This tool takes no inputs.

  • calendarhero_directory_getGet one connected calendar, contact book or other service by its ID.Read-only

    Get Connected Directory

    Get one connected calendar, contact book or other service by its ID. Returns its provider type, category types, name and import dates. Use List Connected Directories to find IDs.

    Inputs

    directory_idstringrequired
    Directory (connection) UUID, from List Connected Directories. Example: 6a1f2c3d-4b5e-6f70-8a9b-0c1d2e3f4a5b.
  • calendarhero_integrations_listList the integration providers CalendarHero supports, optionally by category.Read-only

    List Integrations

    List the integration providers CalendarHero supports, optionally by category. Returns each provider with its type and name. Use List Connected Directories for the services the user has connected.

    Inputs

    orgboolean
    Return the organization's integrations instead of the user's. Example: false.
    typestring
    Only integrations of this category, for example calendar, contacts, video or crm. Example: calendar.one of calendarcontactsmessagingsocialemailsearchfilesgroupsfaqcrmticketroomsvideoatspayment
  • calendarhero_meeting_categories_getGet stats on the user's meetings by category for a month.Read-only

    Get Meeting Categories

    Get stats on the user's meetings by category for a month. Returns meeting counts and time per category. Use List Meetings for the meetings themselves.

    Inputs

    monthstring
    Month as YYYY-MM. Example: 2026-11.