HappyScribe connector for AI agents

CALL ANY TOOL

Search, summarize, and organize transcriptions end to end, scoped to each user's own HappyScribe workspace.

happyscribemcp_search_transcriptions

Search transcriptions

Search for exact text or keywords within transcription content, like grep across your workspace.

Parameters

Name

Type

Required

Description

query

string

Required

Text or keywords to search for within transcription content.

folder_id

integer

Optional

Restrict the search to a specific folder.

happyscribemcp_create_transcription

Create transcription

happyscribemcp_get_folder_hierarchy

Get folder hierarchy

happyscribemcp_create_summary_template

Create summary template

happyscribemcp_create_folder

Create folder

happyscribemcp_delete_transcriptions

Delete transcriptions

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// HappyScribe tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["happyscribemcp"], toolNames: [
    "happyscribemcp_search_transcriptions",
    "happyscribemcp_create_transcription",
    "happyscribemcp_get_folder_hierarchy"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Search this week's transcripts for churn risk mentions" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["happyscribemcp"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Search this week's transcripts for churn risk mentions" }],
  tools,
});

// Execute the tool call with the user's vaulted happyscribemcp credential
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["happyscribemcp"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Search this week's transcripts for churn risk mentions" }],
  tools,
});

// Tool call runs with the user's vaulted happyscribemcp credential
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["happyscribemcp"] }, pageSize: 100,
});

const agent = new Agent({
  name: "happyscribemcp_agent",
  model: "gemini-2.5-pro",
  instruction: "HappyScribe tools scoped to this user",
  tools,
});

await agent.run("Search this week's transcripts for churn risk mentions");

Try these prompts

Copy any prompt into your agent. Each maps directly to a HappyScribe tool. Click to copy, paste into your agent, done.

Search transcripts

Copy the prompt

Copied

Search this week's transcripts for mentions of 'churn risk'.

Copy the prompt

Copied

Find and replace 'Q3' with 'Q4' in transcription 8821.

Copy the prompt

Copied

Get the folder hierarchy under the Sales root folder.

Summaries and templates

Copy the prompt

Copied

Create a summary template for weekly engineering standups.

Copy the prompt

Copied

Update the customer-call summary template to add a Risks section.

Copy the prompt

Copied

Set the meeting summary template to 'Sales Call' for future meetings.

Organize and clean up

Copy the prompt

Copied

Create a folder named Q4 Renewals under Customer Calls.

Copy the prompt

Copied

Delete transcriptions 8821 and 8822.

Copy the prompt

Copied

Upload this recording for transcription in English.

SEE HOW AUTH WORKS

Your users connect once. Their HappyScribe credentials stay vaulted, every call is checked, and every action is logged.

1

Authorize

Your user connects

HappyScribe

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

2

Store

Their

HappyScribe

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

3

Resolve

When your agent calls a

HappyScribe

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

4

Audit

Every

HappyScribe

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other meeting and transcription connectors.

SALES

Sales call prep agent

Pull Granola notes and Attio contact history to draft a pre-call brief before every sales meeting. Zero rep input.

Granola

Attio

View agent

SALES

Deal intelligence agent

Combine Gong, Attio, and Slack signals to surface deal risks and next-best actions. Updated after every call.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

Other connector libraries treat auth as a demo afterthought. Scalekit starts with identity, scope enforcement, and audit. Connectors follow.

01.

Shared tokens break per-user analytics

A shared HappyScribe token looks fine in a demo. In production every transcript looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

HappyScribe today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access HappyScribe as the user or through a shared key?

As the user. Scalekit resolves the credential of the person who triggered the agent at request time, so every HappyScribe action in your audit trail is attributed to a real user, not a shared service account.

Where is the HappyScribe token stored?

In an AES-256 encrypted vault with per-tenant namespacing. Tokens are resolved at request time, never enter LLM context, refresh automatically, and can be revoked from one dashboard.

Can I limit what the agent does in HappyScribe?

Yes. Filter by tool name in listScopedTools to expose only what you want. Scalekit also enforces scope checks before every API call.

What happens when a user revokes access?

The credential is invalidated at the next tool call. The call fails closed, other users' connections are unaffected, and the revocation is logged in the audit chain.

Can the agent search transcripts across the whole workspace or just one folder?

Both. search_transcriptions searches the full workspace by default; pass folder_id to restrict results to a specific project or client folder.

HappyScribe

Tools your meeting agent reaches for on HappyScribe, scoped per user.