Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Read AI MCP connector

OAuth2.1/DCRAITranscriptionProductivity

Connect to Read AI to access your meeting intelligence — transcripts, summaries, action items, and insights from meetings, emails, and chats. Retrieve...

Read AI MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “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. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'readaimcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Read AI MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'readaimcp_list_meetings',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • List meetings — List Read AI meetings for the authenticated user with optional start-time filters and cursor-based pagination
  • Get meeting by id — Retrieve a single Read AI meeting by its ULID identifier, with optional expansion of rich meeting content such as summary, transcript, action items, topics, metrics, and recording download link
  • Create meeting agent — Send a Read AI meeting agent (bot) to a video conferencing meeting to record and transcribe it

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

readaimcp_create_meeting_agent#Send a Read AI meeting agent (bot) to a video conferencing meeting to record and transcribe it. Supports Zoom, Google Meet, and Microsoft Teams. The agent joins the meeting automatically and produces a recording, transcript, and AI-generated summary upon completion. When to use: Use this tool to dispatch a Read AI bot to an upcoming or in-progress meeting so it can record and transcribe the session. Provide either a meeting_url (simplest) or a meeting_platform + meeting_id combination. Use start_time to schedule the bot for a future meeting. When NOT to use: Do not use this tool to retrieve meeting content — use get_meeting_by_id or list_meetings instead. Do not use this tool for meetings on unsupported platforms.5 params

Send a Read AI meeting agent (bot) to a video conferencing meeting to record and transcribe it. Supports Zoom, Google Meet, and Microsoft Teams. The agent joins the meeting automatically and produces a recording, transcript, and AI-generated summary upon completion. When to use: Use this tool to dispatch a Read AI bot to an upcoming or in-progress meeting so it can record and transcribe the session. Provide either a meeting_url (simplest) or a meeting_platform + meeting_id combination. Use start_time to schedule the bot for a future meeting. When NOT to use: Do not use this tool to retrieve meeting content — use get_meeting_by_id or list_meetings instead. Do not use this tool for meetings on unsupported platforms.

NameTypeRequiredDescription
meeting_idstringoptionalThe platform-specific meeting identifier. Required unless meeting_url is provided.
meeting_passwordstringoptionalOptional meeting passcode/password if required to join.
meeting_platformstringoptionalThe video meeting platform (e.g. 'zoom', 'meet', 'teams'). Required unless meeting_url is provided.
meeting_urlstringoptionalOptional full meeting URL. When provided, meeting_platform and meeting_id are derived from the URL automatically.
start_timestringoptionalOptional start time in ISO 8601 format. If omitted, the agent joins the meeting immediately.
readaimcp_get_meeting_by_id#Retrieve a single Read AI meeting by its ULID identifier, with optional expansion of rich meeting content such as summary, transcript, action items, topics, metrics, and recording download link. When to use: Use this tool when you need full details about a specific meeting you already know the ID for — for example, to fetch the transcript, action items, or chapter summaries after a meeting completes. When NOT to use: Do not use this tool to search or browse meetings by date or keyword — use list_meetings instead.2 params

Retrieve a single Read AI meeting by its ULID identifier, with optional expansion of rich meeting content such as summary, transcript, action items, topics, metrics, and recording download link. When to use: Use this tool when you need full details about a specific meeting you already know the ID for — for example, to fetch the transcript, action items, or chapter summaries after a meeting completes. When NOT to use: Do not use this tool to search or browse meetings by date or keyword — use list_meetings instead.

NameTypeRequiredDescription
idstringrequiredMeeting ULID — the unique 26-character identifier for the meeting.
expandstringoptionalList of expandable fields to include in the response. When omitted, only base meeting metadata is returned.
readaimcp_list_meetings#List Read AI meetings for the authenticated user with optional start-time filters and cursor-based pagination. Returns up to 10 meetings per page. When to use: Use this tool to browse, search, or paginate through meetings — for example, to find all meetings within a date range, retrieve recent meetings, or iterate through all meetings using cursor-based pagination. When NOT to use: Do not use this tool when you already know the meeting ULID and need full content — use get_meeting_by_id instead.7 params

List Read AI meetings for the authenticated user with optional start-time filters and cursor-based pagination. Returns up to 10 meetings per page. When to use: Use this tool to browse, search, or paginate through meetings — for example, to find all meetings within a date range, retrieve recent meetings, or iterate through all meetings using cursor-based pagination. When NOT to use: Do not use this tool when you already know the meeting ULID and need full content — use get_meeting_by_id instead.

NameTypeRequiredDescription
cursorstringoptionalCursor for pagination. Pass the ULID of the last meeting from the previous page to retrieve the next page.
expandstringoptionalList of expandable fields to include in the response for each meeting. When omitted, only base metadata is returned.
limitintegeroptionalThe number of results to return per page. Maximum is 10.
start_datetime_gtstringoptionalOnly return meetings with start times strictly after this datetime (exclusive lower bound). ISO 8601 format.
start_datetime_gtestringoptionalOnly return meetings with start times on or after this datetime (inclusive lower bound). ISO 8601 format.
start_datetime_ltstringoptionalOnly return meetings with start times strictly before this datetime (exclusive upper bound). ISO 8601 format.
start_datetime_ltestringoptionalOnly return meetings with start times on or before this datetime (inclusive upper bound). ISO 8601 format.