HappyScribe

Get detailed information about a specific transcription

get_transcription

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

get_transcriptions

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.

get_video_frames

Get information about the current workspace this connection has access to

get_workspace

List calendar events (scheduled meetings) with their recording status. Use this to see what meetings are scheduled, which will be recorded, and prepare for upcoming meetings. Supports date filtering to find meetings in specific time ranges (past, present, or future). Can filter by series_ids to get all instances of recurring meeting series. The current year is 2026.

list_calendar_events

List glossaries in the workspace. Glossaries define terminology that should be used consistently in transcriptions and translations — preferred spellings, proper nouns, domain-specific terms, etc.

list_glossaries

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.

list_read_files

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.

list_summary_templates

List transcriptions accessible to the user with optional filtering. Returns results ordered by creation date (newest first). A good starting point to see recent transcriptions. When the user asks about their own transcriptions (e.g. "my files", "my meetings", "meetings I was in", "calls I had this week"), pass scope: 'mine' — it restricts results to files the user owns, participated in (as speaker or calendar attendee), or that were directly shared with them, mirroring the dashboard "My files" view. Without it, results include every file the user can access via folder permissions. If there are too many results to browse, get_folder_hierarchy shows the folder structure so you can narrow down with folder_path. Supports filtering by folder (folder_path), location, date range, person, company, and pagination. When filtering by person or company, list_people or list_companies can help find the exact name first; person_email is the most reliable filter.

list_transcriptions

Move one or more transcriptions to a different folder in the same organization. Accepts up to 50 transcription IDs per call. Use list_transcriptions or get_folder_hierarchy to look up the destination folder ID first. Cross-organization moves are not supported. Authorization is checked per transcription and on the destination folder; if any check fails, no transcriptions are moved.

move_transcriptions

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.

reassign_speakers

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.

regenerate_summary

Rename a folder.

rename_folder

Rename one or more speakers in a transcription. Pass a mapping of current speaker label -> new speaker label, e.g. { "Speaker 1": "Alice", "Speaker 2": "Bob" }. All paragraphs whose speaker matches a key are updated. Match is exact (case-sensitive). Use get_transcription first to see the current speaker labels.

rename_speakers

Rename a single transcription.

rename_transcription

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.

replace_text_in_transcript

Re-runs automatic transcription (ASR) on the existing media of a transcription already in the workspace, replacing the current transcript in place (the transcription keeps its ID). This replaces everything: transcript text, speaker diarization, and speaker labels. Any edits the user made — including renamed speakers — will be lost (recoverable from version history inside the editor). There is no way to reprocess only one aspect; retranscription always re-runs the full pipeline. Use this to fix a file that was transcribed in the wrong language, or to re-process it after its settings changed. Only finished automatic transcriptions with their media still available can be retranscribed. Retranscription runs in the background — poll with get_transcription (display_mode: metadata_only) until the state is "done".

retranscribe

Search HappyScribe helpdesk articles to answer questions about product features, policies, and how-to guides. Use this when the user asks about: how HappyScribe works, product documentation, feature explanations, pricing details, data policies (e.g., "how long are files stored?", "is my data used for training?"), account settings, troubleshooting, or any question that might be answered in help documentation. This searches published help center articles and returns relevant excerpts with links to the full articles.

search_helpdesk

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.

search_transcriptions

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.

set_meeting_template

Verifies quote text against the actual transcription content and returns precise timestamps and working links to each quote in the editor. Recommended when extracting quotes — links or timestamps generated from memory are usually incorrect. Counts as a file read (same quota as get_transcription with full_text).

verify_quotes