HappyScribe connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

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

   Node.js

   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 = 'happyscribemcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize HappyScribe:', 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: 'happyscribemcp_get_folder_hierarchy',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "happyscribemcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize HappyScribe:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="happyscribemcp_get_folder_hierarchy",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Quotes verify — REQUIRED for quote extraction: Verifies quote text against the actual transcription content and returns precise timestamps and working links to each quote in the editor
• File upload — Upload an audio or video file to HappyScribe for transcription
• Update summary template, project notes — Update an existing summary template
• Template set meeting — Configure which summary template to use for future meetings
• Search transcriptions, helpdesk — Search for exact text/keywords within transcription content (like grep)
• Transcript replace text in — Find and replace exact text in a transcription

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.

happyscribemcp_create_folder#Create a new folder in the workspace. Folders help organize transcriptions by project, client, or any other grouping.2 params▾

Create a new folder in the workspace. Folders help organize transcriptions by project, client, or any other grouping.

NameTypeRequiredDescription

namestringrequiredFolder name

parent_idintegeroptionalParent folder ID. Omit to create at workspace root.

happyscribemcp_create_summary_template#Create a new meeting summary template. The body is markdown where each ## heading becomes a section in the generated summary. Optionally include meeting context to give the AI additional instructions about the type of meeting.4 params▾

Create a new meeting summary template. The body is markdown where each ## heading becomes a section in the generated summary. Optionally include meeting context to give the AI additional instructions about the type of meeting.

NameTypeRequiredDescription

bodystringrequiredTemplate body in markdown. Use ## headings to define sections (e.g. "## Key Points\n\nCapture main topics\n\n## Action Items\n\nList next steps")

namestringrequiredTemplate name (max 100 characters)

meeting_contextstringoptionalOptional context about the meeting type, sent to the AI alongside the template (e.g. "This is a weekly engineering standup")

visibilitystringoptionalWho can see and use this template: "private" (only you, default) or "workspace" (all team members)

happyscribemcp_create_transcription#Create a new transcription job from an already-uploaded file or an existing HappyScribe file ID. Use upload_file to upload new files. Returns the transcription ID.4 params▾

Create a new transcription job from an already-uploaded file or an existing HappyScribe file ID. Use upload_file to upload new files. Returns the transcription ID.

NameTypeRequiredDescription

file_idstringoptionalHappyScribe file ID to transcribe

folder_idintegeroptionalFolder ID to place the result in

languagestringoptionalLanguage code (e.g. "en", "fr")

namestringoptionalDisplay name for the transcription

happyscribemcp_delete_folder#Delete a folder and all its contents. This is a destructive operation — all transcriptions inside are moved to trash. Use with caution.1 param▾

Delete a folder and all its contents. This is a destructive operation — all transcriptions inside are moved to trash. Use with caution.

NameTypeRequiredDescription

idintegerrequiredFolder ID to delete

happyscribemcp_delete_summary_template#Delete a summary template. Only the template creator or a workspace admin can delete it. The template is soft-deleted and can be recovered within 10 days.1 param▾

Delete a summary template. Only the template creator or a workspace admin can delete it. The template is soft-deleted and can be recovered within 10 days.

NameTypeRequiredDescription

idintegerrequiredTemplate ID to delete

happyscribemcp_delete_transcriptions#Delete one or more transcriptions. Deleted transcriptions are moved to trash and can be recovered within 30 days. Use with caution.1 param▾

Delete one or more transcriptions. Deleted transcriptions are moved to trash and can be recovered within 30 days. Use with caution.

NameTypeRequiredDescription

idsarrayrequiredArray of transcription IDs (hashed_id) to delete

happyscribemcp_get_conversation#Get the full content of an AI conversation, including all messages and responses.1 param▾

Get the full content of an AI conversation, including all messages and responses.

NameTypeRequiredDescription

idintegerrequiredConversation ID (from list_conversations)

happyscribemcp_get_folder_hierarchy#Get the complete folder tree for the workspace or a specific root folder. Returns a nested structure with folder names, IDs, and paths. Use this before list_transcriptions to understand the organization and find the right folder_path to filter by.1 param▾

Get the complete folder tree for the workspace or a specific root folder. Returns a nested structure with folder names, IDs, and paths. Use this before list_transcriptions to understand the organization and find the right folder_path to filter by.

NameTypeRequiredDescription

root_folder_idintegeroptionalStart from this folder ID instead of the workspace root. Useful to explore a subtree without loading the entire hierarchy.

happyscribemcp_get_glossary#Get the full contents of a glossary, including all custom terms and their definitions.1 param▾

Get the full contents of a glossary, including all custom terms and their definitions.

NameTypeRequiredDescription

idintegerrequiredGlossary ID (from list_glossaries)

happyscribemcp_get_helpdesk_article#Get the full content of a HappyScribe help article by ID. Use search_helpdesk first to find relevant article IDs.1 param▾

Get the full content of a HappyScribe help article by ID. Use search_helpdesk first to find relevant article IDs.

NameTypeRequiredDescription

idstringrequiredHelp article ID (from search_helpdesk results)

happyscribemcp_get_meeting_diagnostics#Get technical diagnostics for a meeting recording: Notetaker join status, recording state, processing errors, and timeline events. Use this when a meeting recording is missing or has issues.1 param▾

Get technical diagnostics for a meeting recording: Notetaker join status, recording state, processing errors, and timeline events. Use this when a meeting recording is missing or has issues.

NameTypeRequiredDescription

calendar_event_idintegerrequiredCalendar event ID (from list_calendar_events)

happyscribemcp_get_project#Get details of a specific project: name, instructions, notes, files, and members. Use list_projects first to find the project ID.1 param▾

Get details of a specific project: name, instructions, notes, files, and members. Use list_projects first to find the project ID.

NameTypeRequiredDescription

idintegerrequiredThe project ID (from list_projects)

happyscribemcp_get_summary_template#Get the full details of a summary template by ID (for user/workspace templates) or slug (for system templates). Returns the name, markdown body, sections, meeting context, and visibility.2 params▾

Get the full details of a summary template by ID (for user/workspace templates) or slug (for system templates). Returns the name, markdown body, sections, meeting context, and visibility.

NameTypeRequiredDescription

idintegeroptionalTemplate ID (for user or workspace templates)

slugstringoptionalTemplate slug (for system templates, e.g. "general_meeting_notes")

happyscribemcp_get_transcription#Get detailed information about a specific transcription2 params▾

Get detailed information about a specific transcription

NameTypeRequiredDescription

idstringrequiredThe transcription ID (hashed_id)

display_modestringoptionalDisplay mode: full_text (default, complete transcription), summary (AI-generated summary), or metadata_only (no content).

happyscribemcp_get_transcriptions#Get detailed information about multiple transcriptions at once. Use this after listing transcriptions to get full content/summaries for multiple files efficiently.2 params▾

Get detailed information about multiple transcriptions at once. Use this after listing transcriptions to get full content/summaries for multiple files efficiently.

NameTypeRequiredDescription

idsarrayrequiredArray of transcription IDs (hashed_id) to retrieve (max 5)

display_modestringoptionalDisplay mode: full_text (default, complete transcription), summary (AI-generated summary), or metadata_only (no content).

happyscribemcp_get_video_frames#Extract visual frames (screenshots) from a video recording at specific timestamps. Use this when the conversation references something visual — a screen share, presentation, diagram, or UI — and you need to see what was on screen. Returns the frames as images. Only works for video recordings (meetings, screen recordings); audio-only files have no frames.3 params▾

Extract visual frames (screenshots) from a video recording at specific timestamps. Use this when the conversation references something visual — a screen share, presentation, diagram, or UI — and you need to see what was on screen. Returns the frames as images. Only works for video recordings (meetings, screen recordings); audio-only files have no frames.

NameTypeRequiredDescription

idstringrequiredThe transcription ID (hashed_id)

timestampsarrayrequiredTimestamps in seconds to extract frames from (max 3). Use timestamps from the transcription content to target moments of interest.

skip_cachebooleanoptionalSkip cached results and force a fresh extraction. Use only if a previous result was wrong.

happyscribemcp_get_workspace#Get information about the current workspace: name, plan, member count, storage usage, and feature flags.0 params▾

Get information about the current workspace: name, plan, member count, storage usage, and feature flags.

happyscribemcp_list_calendar_events#List calendar events with their associated recordings and transcription status. Use this to see upcoming and past meetings, check recording status, and find calendar_event_id for other tools.4 params▾

List calendar events with their associated recordings and transcription status. Use this to see upcoming and past meetings, check recording status, and find calendar_event_id for other tools.

NameTypeRequiredDescription

limitintegeroptionalMaximum number of results (default: 20, max: 100)

offsetintegeroptionalNumber of results to skip for pagination

starts_afterstringoptionalReturn only events starting after this ISO-8601 date-time

starts_beforestringoptionalReturn only events starting before this ISO-8601 date-time

happyscribemcp_list_conversations#List AI conversations in a project. Conversations are threaded AI chat sessions within a project context, used to analyze and query transcriptions.1 param▾

List AI conversations in a project. Conversations are threaded AI chat sessions within a project context, used to analyze and query transcriptions.

NameTypeRequiredDescription

project_idintegerrequiredProject ID (from list_projects) to list conversations for

happyscribemcp_list_glossaries#List custom glossaries in the workspace. Glossaries define custom vocabulary (names, jargon, technical terms) that improve transcription accuracy.0 params▾

List custom glossaries in the workspace. Glossaries define custom vocabulary (names, jargon, technical terms) that improve transcription accuracy.

happyscribemcp_list_projects#List projects in the workspace. Projects group transcriptions, instructions, and AI conversations around a specific goal (e.g., a research study, client engagement, story).2 params▾

List projects in the workspace. Projects group transcriptions, instructions, and AI conversations around a specific goal (e.g., a research study, client engagement, story).

NameTypeRequiredDescription

limitintegeroptionalMaximum number of results (default: 20, max: 100)

statusstringoptionalFilter by status: active, completed, archived, or all (default: active)

happyscribemcp_list_read_files#List files already read this month and show remaining quota. Some plans have a monthly limit on how many unique files can be read with display_mode: "full_text" — once a file has been read, re-reading it is always free. Summaries and metadata are also always free.0 params▾

List files already read this month and show remaining quota. Some plans have a monthly limit on how many unique files can be read with display_mode: "full_text" — once a file has been read, re-reading it is always free. Summaries and metadata are also always free.

happyscribemcp_list_summary_templates#List meeting summary templates available in the workspace. Returns your private templates, shared workspace templates created by teammates, and built-in system templates. Templates define the structure and sections of AI-generated meeting summaries.0 params▾

List meeting summary templates available in the workspace. Returns your private templates, shared workspace templates created by teammates, and built-in system templates. Templates define the structure and sections of AI-generated meeting summaries.

happyscribemcp_list_transcriptions#List transcriptions accessible to the user with optional filtering. Returns results ordered by creation date (newest first). START HERE to see recent transcriptions. When the user asks about THEIR OWN transcriptions (e.g. "my files", "my meetings", "what have I been working on") ALWAYS pass scope: 'mine'. Without scope: 'mine', this tool returns every file the user can technically access via folder permissions, which is usually NOT what "my files" means. Supports filtering by folder, location, date range, person, company, and pagination.14 params▾

List transcriptions accessible to the user with optional filtering. Returns results ordered by creation date (newest first). START HERE to see recent transcriptions. When the user asks about THEIR OWN transcriptions (e.g. "my files", "my meetings", "what have I been working on") ALWAYS pass scope: 'mine'. Without scope: 'mine', this tool returns every file the user can technically access via folder permissions, which is usually NOT what "my files" means. Supports filtering by folder, location, date range, person, company, and pagination.

NameTypeRequiredDescription

company_domainstringoptionalFilter by company domain (e.g., "acme.com").

company_namestringoptionalFilter by company name. Returns transcriptions where anyone from that company was involved.

created_afterstringoptionalReturn only transcriptions created on or after this ISO-8601 date-time

created_beforestringoptionalReturn only transcriptions created before this ISO-8601 date-time

file_originstringoptionalFilter by file origin: 'recording' (captured live) or 'upload' (user-uploaded file).

folder_idintegeroptionalFilter by folder ID. Returns transcriptions in this folder only.

folder_pathstringoptionalFilter by folder path (e.g., "/My Folder/Subfolder"). Returns transcriptions in this folder only.

limitintegeroptionalMaximum number of results to return (default: 20, max: 250)

locationstringoptionalFilter by location: workspace (team files), private (your personal files), or shared (files shared with you by others).

offsetintegeroptionalNumber of results to skip for pagination (default: 0)

person_emailstringoptionalFilter by person email (matches primary and secondary emails).

person_namestringoptionalFilter by person name. Returns transcriptions where this person was involved.

preview_modestringoptionalPreview mode: none (default), summary (AI-generated summary), or beginning (first ~500 words).

scopestringoptionalUse scope: 'mine' to return only transcriptions associated with the current user — files they own, participated in, or that were directly shared with them.

happyscribemcp_move_transcriptions#Move one or more transcriptions to a different folder. Returns the updated transcriptions.2 params▾

Move one or more transcriptions to a different folder. Returns the updated transcriptions.

NameTypeRequiredDescription

folder_idintegerrequiredTarget folder ID. Use get_folder_hierarchy to find folder IDs.

idsarrayrequiredArray of transcription IDs (hashed_id) to move

happyscribemcp_reassign_speakers#Reassign speakers for one or more time ranges in a transcription. The server splits affected paragraphs at word boundaries and assigns the given speaker label to all words in each range. Adjacent paragraphs with the same speaker are merged automatically. Use this to fix diarization errors where paragraphs contain speech from multiple people. Returns the resulting speaker timeline so you can verify the changes.2 params▾

Reassign speakers for one or more time ranges in a transcription. The server splits affected paragraphs at word boundaries and assigns the given speaker label to all words in each range. Adjacent paragraphs with the same speaker are merged automatically. Use this to fix diarization errors where paragraphs contain speech from multiple people. Returns the resulting speaker timeline so you can verify the changes.

NameTypeRequiredDescription

idstringrequiredTranscription ID (hashed_id).

segmentsarrayrequiredTime ranges to reassign. Each segment specifies a time range and the speaker to assign.

happyscribemcp_regenerate_summary#Regenerate the meeting summary for a transcription. Optionally specify a template to use — otherwise the existing template (or the default from the resolution chain) is used. The summary is generated asynchronously; use get_transcription to check the result.3 params▾

Regenerate the meeting summary for a transcription. Optionally specify a template to use — otherwise the existing template (or the default from the resolution chain) is used. The summary is generated asynchronously; use get_transcription to check the result.

NameTypeRequiredDescription

transcription_idstringrequiredTranscription ID (hashed_id)

template_idintegeroptionalTemplate ID to use (for user/workspace templates). Omit to keep the current template.

template_slugstringoptionalTemplate slug to use (for system templates, e.g. "discovery_call"). Omit to keep the current template.

happyscribemcp_rename_folder#Rename a folder. The folder ID can be found using get_folder_hierarchy.2 params▾

Rename a folder. The folder ID can be found using get_folder_hierarchy.

NameTypeRequiredDescription

idintegerrequiredFolder ID to rename

namestringrequiredNew folder name

happyscribemcp_rename_speakers#Rename one or more speakers in a transcription. Pass a mapping of current speaker label -> new speaker label. All paragraphs whose speaker matches a key are updated. Match is exact (case-sensitive). Use get_transcription first to see the current speaker labels.2 params▾

Rename one or more speakers in a transcription. Pass a mapping of current speaker label -> new speaker label. All paragraphs whose speaker matches a key are updated. Match is exact (case-sensitive). Use get_transcription first to see the current speaker labels.

NameTypeRequiredDescription

idstringrequiredTranscription ID (hashed_id).

mappingobjectrequiredMapping from current speaker label to new speaker label. Keys must match speaker labels exactly (case-sensitive). Values are the new labels.

happyscribemcp_rename_transcription#Rename a transcription file. Updates the display name shown in the dashboard and folder listings.2 params▾

Rename a transcription file. Updates the display name shown in the dashboard and folder listings.

NameTypeRequiredDescription

idstringrequiredTranscription ID (hashed_id)

namestringrequiredNew display name for the transcription

happyscribemcp_replace_text_in_transcript#Find and replace exact text in a transcription. Replaces every occurrence of `find` with `replace` across all paragraphs. Optionally constrain to a time window with `from_seconds` and `to_seconds` — only occurrences whose word-level timestamps intersect that window are replaced. Use this to fix consistent typos, names, or product mentions. For speaker label changes, use rename_speakers instead.5 params▾

Find and replace exact text in a transcription. Replaces every occurrence of `find` with `replace` across all paragraphs. Optionally constrain to a time window with `from_seconds` and `to_seconds` — only occurrences whose word-level timestamps intersect that window are replaced. Use this to fix consistent typos, names, or product mentions. For speaker label changes, use rename_speakers instead.

NameTypeRequiredDescription

findstringrequiredExact text to find (case-sensitive). Cannot be empty.

idstringrequiredTranscription ID (hashed_id).

replacestringrequiredReplacement text. Can be empty (deletes the matched text).

from_secondsnumberoptionalOptional lower bound (in seconds) of the time window.

to_secondsnumberoptionalOptional upper bound (in seconds) of the time window.

happyscribemcp_search_helpdesk#Search HappyScribe's help documentation for articles about features, troubleshooting, and how-to guides.1 param▾

Search HappyScribe's help documentation for articles about features, troubleshooting, and how-to guides.

NameTypeRequiredDescription

querystringrequiredSearch query for help articles

happyscribemcp_search_transcriptions#Search for exact text/keywords within transcription content (like grep). Use this to find specific names, product names, or exact phrases. For browsing by topic, date, or category, use get_folder_hierarchy + list_transcriptions instead.5 params▾

Search for exact text/keywords within transcription content (like grep). Use this to find specific names, product names, or exact phrases. For browsing by topic, date, or category, use get_folder_hierarchy + list_transcriptions instead.

NameTypeRequiredDescription

querystringrequiredSearch query to find in transcription content

created_afterstringoptionalReturn only transcriptions created on or after this ISO-8601 date-time

created_beforestringoptionalReturn only transcriptions created before this ISO-8601 date-time

limitintegeroptionalMaximum number of results to return (default: 20)

offsetintegeroptionalNumber of results to skip for pagination (default: 0)

happyscribemcp_set_meeting_template#Configure which summary template to use for future meetings. With scope "meeting": sets the template on a calendar event (and all upcoming instances if recurring). With scope "default": sets the template as your personal default for all future meetings.4 params▾

Configure which summary template to use for future meetings. With scope "meeting": sets the template on a calendar event (and all upcoming instances if recurring). With scope "default": sets the template as your personal default for all future meetings.

NameTypeRequiredDescription

scopestringrequired"meeting" to set on this meeting/series, "default" to set as your personal default

calendar_event_idintegeroptionalCalendar event ID (required when scope is "meeting", get from list_calendar_events)

template_idintegeroptionalTemplate ID (for user/workspace templates)

template_slugstringoptionalTemplate slug (for system templates)

happyscribemcp_update_project_notes#Update the AI memory for a project. Use this to persist key findings, decisions, and patterns discovered across conversations. Keep notes concise, structured, and factual. Only use when you discover something important that should persist across conversations.2 params▾

Update the AI memory for a project. Use this to persist key findings, decisions, and patterns discovered across conversations. Keep notes concise, structured, and factual. Only use when you discover something important that should persist across conversations.

NameTypeRequiredDescription

idintegerrequiredThe project ID

notesstringrequiredThe updated AI memory content (replaces existing memory entirely)

happyscribemcp_update_summary_template#Update an existing summary template. Only the template creator can edit it. Pass only the fields you want to change — omitted fields are left unchanged.5 params▾

Update an existing summary template. Only the template creator can edit it. Pass only the fields you want to change — omitted fields are left unchanged.

NameTypeRequiredDescription

idintegerrequiredTemplate ID

bodystringoptionalNew template body in markdown

meeting_contextstringoptionalNew meeting context (pass empty string to clear)

namestringoptionalNew template name

visibilitystringoptionalNew visibility setting

happyscribemcp_upload_file#Upload an audio or video file to HappyScribe for transcription. Supports direct file upload (base64) or transcription from a public URL. Returns the transcription ID which can be used with get_transcription to check status and retrieve results.6 params▾

Upload an audio or video file to HappyScribe for transcription. Supports direct file upload (base64) or transcription from a public URL. Returns the transcription ID which can be used with get_transcription to check status and retrieve results.

NameTypeRequiredDescription

file_contentstringoptionalBase64-encoded file content (mutually exclusive with url)

filenamestringoptionalFilename with extension (e.g. "meeting.mp4"). Required when using file_content.

folder_idintegeroptionalFolder ID to place the transcription in. Defaults to the user's root folder.

languagestringoptionalLanguage code (e.g. "en", "fr", "es"). Defaults to workspace default if omitted.

namestringoptionalDisplay name for the transcription. Defaults to the filename.

urlstringoptionalPublic URL of the audio/video file to transcribe (mutually exclusive with file_content)

happyscribemcp_verify_quotes#REQUIRED for quote extraction: Verifies quote text against the actual transcription content and returns precise timestamps and working links to each quote in the editor. This is the ONLY reliable way to get accurate quote positions — never generate links or timestamps from memory as they will be incorrect. Always call this tool immediately after identifying quotes to extract. Counts as a file read (same quota as get_transcription with full_text).2 params▾

REQUIRED for quote extraction: Verifies quote text against the actual transcription content and returns precise timestamps and working links to each quote in the editor. This is the ONLY reliable way to get accurate quote positions — never generate links or timestamps from memory as they will be incorrect. Always call this tool immediately after identifying quotes to extract. Counts as a file read (same quota as get_transcription with full_text).

NameTypeRequiredDescription

idstringrequiredThe transcription ID (hashed_id)

quotesarrayrequiredArray of quotes to verify (max 20 per request)