Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Recall AI

Scalekit connector
Open markdown

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

Tools
71
What they doRead · write · destructive
29 · 27 · 1529 read27 write15 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 Recall AI connection

    In AgentKit > Connections, create a Recall AI 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 = 'recall'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Recall AI:', 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: 'recall_audio_mixed_list',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Recall AI 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
  • recall_audio_mixed_getGet one mixed audio artifact from Recall.ai by id.Read-only

    Get Mixed Audio

    Get one mixed audio artifact from Recall.ai by id. Returns id, recording, status, format, metadata and data.download_url for the audio file. Use audio_mixed_get to download one artifact. Use audio_mixed_list to find artifacts by recording.

    Inputs

    audio_mixed_idstringrequired
    UUID of the mixed audio artifact. Get it from List Mixed Audio Files or the recording's media_shortcuts.
  • recall_audio_mixed_listList mixed audio files in the Recall.ai workspace, filtered by recording, status or creation time.Read-only

    List Mixed Audio Files

    List mixed audio files in the Recall.ai workspace, filtered by recording, status or creation time. Returns a page with next, previous and results; each item has id, recording, status, metadata and data with download links. Use audio_mixed_list to find mixed audio files for a recording. Use audio_mixed_get when you already have the id.

    Inputs

    created_at_afterstring
    Only return items created at or after this ISO 8601 date-time, e.g. 2024-06-01T00:00:00Z.
    created_at_beforestring
    Only return items created before this ISO 8601 date-time, e.g. 2024-06-30T23:59:59Z.
    cursorstring
    Pagination cursor for the next page. Copy the `cursor` query value from the `next` URL of the previous response; leave empty for the first page.
    recording_idstring
    Only return items that belong to this recording UUID. Get it from List Recordings or a bot's `recordings` array.
    status_codestring
    Only artifacts in this status.one of processingdonefailed
  • recall_audio_separate_getGet one separate audio artifact from Recall.ai by id.Read-only

    Get Separate Audio

    Get one separate audio artifact from Recall.ai by id. Returns id, recording, status, format, metadata and data with download links for each participant's audio. Use audio_separate_get to download one artifact. Use audio_separate_list to find artifacts by recording.

    Inputs

    audio_separate_idstringrequired
    UUID of the separate audio artifact. Get it from List Separate Audio Artifacts or the recording's media_shortcuts.
  • recall_audio_separate_listList separate audio artifacts in the Recall.ai workspace, filtered by recording, status or creation time.Read-only

    List Separate Audio Artifacts

    List separate audio artifacts in the Recall.ai workspace, filtered by recording, status or creation time. Returns a page with next, previous and results; each item has id, recording, status, metadata and data with download links. Use audio_separate_list to find separate audio artifacts for a recording. Use audio_separate_get when you already have the id.

    Inputs

    created_at_afterstring
    Only return items created at or after this ISO 8601 date-time, e.g. 2024-06-01T00:00:00Z.
    created_at_beforestring
    Only return items created before this ISO 8601 date-time, e.g. 2024-06-30T23:59:59Z.
    cursorstring
    Pagination cursor for the next page. Copy the `cursor` query value from the `next` URL of the previous response; leave empty for the first page.
    recording_idstring
    Only return items that belong to this recording UUID. Get it from List Recordings or a bot's `recordings` array.
    status_codestring
    Only artifacts in this status.one of processingdonefailed
  • recall_billing_usage_getGet total bot usage, in seconds, for the Recall.ai workspace over a time range.Read-only

    Get Usage

    Get total bot usage, in seconds, for the Recall.ai workspace over a time range. Returns bot_total, the number of bot seconds used. Use billing_usage_get to report or cap usage. Leave start and end empty for the default range.

    Inputs

    endstring
    Exclusive end of the range, ISO 8601 date-time.
    startstring
    Inclusive start of the range, ISO 8601 date-time.
  • recall_bot_getGet one Recall.ai bot by id.Read-only

    Get Bot

    Get one Recall.ai bot by id. Returns the bot with meeting_url, join_at, recording_config, status_changes and recordings (each with media_shortcuts download links). Use bot_get to check a bot's status or reach its recordings. Use bots_list to search by meeting or status.

    Inputs

    bot_idstringrequired
    UUID of the bot. Get it from List Bots or the `id` returned by Create Bot.
  • recall_bots_listList bots in the Recall.ai workspace, filtered by join time, meeting URL, platform or status.Read-only

    List Bots

    List bots in the Recall.ai workspace, filtered by join time, meeting URL, platform or status. Returns a page with count, next, previous and results; each bot has id, meeting_url, join_at, status_changes and recordings. Use bots_list to find bots. Use bot_get when you already have a bot id.

    Inputs

    join_at_afterstring
    Only bots scheduled to join after this date (YYYY-MM-DD).
    join_at_beforestring
    Only bots scheduled to join before this date (YYYY-MM-DD).
    meeting_urlstring
    Only bots sent to this meeting URL.
    pageinteger
    Page number to return, starting at 1. Use the `next` URL of the previous response to know whether more pages exist.
    platformarray
    Only bots on these meeting platforms. Allowed values: zoom, zoom_rtms, google_meet, google_meet_media_api, microsoft_teams, microsoft_teams_live, webex, goto_meeting, chime_sdk, slack_authenticator, slack_huddle_observer.
    statusarray
    Only bots whose current status is one of these. Allowed values: ready, joining_call, in_waiting_room, in_call_not_recording, recording_permission_allowed, recording_permission_denied, in_call_recording, recording_done, call_ended, done, fatal, media_expired, analysis_done, analysis_failed.
  • recall_calendar_event_getGet one calendar event synced to Recall.ai by id.Read-only

    Get Calendar Event

    Get one calendar event synced to Recall.ai by id. Returns id, calendar_id, start_time, end_time, meeting_url, meeting_platform, ical_uid, is_deleted, raw platform data and scheduled bots. Use calendar_event_get to check one event and its bots. Use calendar_events_list to browse a calendar.

    Inputs

    calendar_event_idstringrequired
    UUID of the calendar event. Get it from List Calendar Events.
All 29 in Transcription