Skip to main content
Glama
Speak AI MCP Server

Speak AI MCP Server

Official
by speakai

What this does

Speak AI transcribes your interviews, sales calls, research sessions, webinars, podcasts, and team meetings, then extracts AI insights like summaries, action items, sentiment, and themes.

This connector is built on MCP, the open standard AI assistants use to connect to apps, so it brings all of that into Claude, ChatGPT, Cursor, Muse or any other MCP-compatible assistant. Once installed, you can ask:

  • "Find the last 10 customer interviews that mention pricing, group the feedback by theme, and cite the source recordings."

  • "Summarize this week's team meetings into decisions, action items, owners, and unresolved risks."

  • "Pull exact customer quotes about onboarding friction from recent research calls and format them for a product brief."

  • "Find a strong 30-second highlight from the latest webinar, create a clip, and export captions."

The AI does the searching, summarizing, and citing. Your recordings stay in your Speak AI workspace; the assistant only queries them through this connector.


Related MCP server: Plaud MCP

Install (pick your tool)

Start with the hosted connector. Every assistant below connects to https://api.speakai.co/v1/mcp and signs you in through your browser on Speak AI's own page, where you can sign in or create a free account. There is no API key to copy. An API key setup is still available for local file upload, scripts and machines with no browser; see Developer reference.

Don't know which one to pick? Install it in the AI assistant you already use. Every option below connects to the same Speak AI account.

Claude.ai (web)

  1. Open claude.ai/settings/connectors

  2. Click Add custom connector

  3. Name it Speak AI and paste https://api.speakai.co/v1/mcp, then click Add

  4. A permission popup asks you to log into Speak AI and click Allow

  5. Done. Speak AI shows in your connector list with its tools ready to use. Open a new chat and ask about your recordings.

3. Add custom connector dialog: name and URL filled in.

Claude add custom connector dialog

5. Connected: Speak AI tools appear in your connector list.

Speak AI connected in Claude

Get a key at app.speakai.co/developers/apikeys, then in step 3 expand Advanced settings and add Authorization = Bearer <your-key> before clicking Add.

Claude Desktop

  1. Open Claude Desktop → Settings → Connectors → Add custom connector

  2. Paste https://api.speakai.co/v1/mcp

  3. Click Add. A permission popup opens. Sign in to Speak AI and click Allow on the screen that appears.

  4. Done.

Get a key at app.speakai.co/developers/apikeys, then in step 2 also expand Custom headers and add:

  • Header name: Authorization

  • Header value: Bearer <your-speak-api-key>

Then click Add.

ChatGPT

Install Speak AI in ChatGPT

  1. Open Speak AI in ChatGPT while signed in to ChatGPT

  2. Click Install plugin

  3. ChatGPT opens a new tab to Speak AI. Sign in (or click Confirm if already logged in) to authorize. You'll be redirected back; close the tab and return to ChatGPT.

  4. Per-chat: open a chat, click the + menu, and enable Speak AI for that chat.

3. Authorize on Speak AI: sign in or click Confirm if you're already signed in.

Speak AI authorization screen

4. Connected: Speak AI now shows in your ChatGPT apps list.

Speak AI connected in ChatGPT

  • Authorization tab doesn't show a "you're connected" page: if you land on the plain Speak AI dashboard with no confirmation, the authorization still went through. Close that tab and return to ChatGPT.

  • Install keeps reopening the dashboard: fully close and reopen ChatGPT, then check Settings → Apps & Connectors. Speak AI should already be listed there.

  • "No actions available" inside a chat: make sure you've enabled Speak AI from the per-chat + menu (step 4 above).

  • Can't install plugins in your ChatGPT account: ask your ChatGPT admin to allow Speak AI, or add it as a custom connector instead: Settings → Apps & Connectors → Advanced, turn on Developer Mode, click Create, paste https://api.speakai.co/v1/mcp and choose OAuth.

Still stuck? Email success@speakai.co.

Claude Code (terminal)

Add the hosted connector, then sign in:

claude mcp add --transport http speakai https://api.speakai.co/v1/mcp
claude mcp login speakai

claude mcp login opens Speak AI's sign-in page in your browser. Sign in or create an account, then click Allow. You can also type /mcp inside Claude Code, pick speakai and choose to authenticate. On a machine with no browser (for example over SSH), run claude mcp login speakai --no-browser, open the printed link on another device, and paste the address your browser ends on back into the terminal.

Add --scope user to the first command to use Speak AI in every project instead of only the current one.

Or install the plugin, which adds the same hosted connector plus Speak AI skills:

  1. Add the official marketplace (one-time): /plugin marketplace add claude-plugins-official

  2. Install the plugin: /plugin install speakai@claude-plugins-official

  3. Activate it: /reload-plugins

  4. Type /mcp, pick speakai and sign in to Speak AI in your browser.

If /plugin install doesn't find Speak AI, refresh the local catalog with /plugin marketplace update claude-plugins-official and retry.

claude mcp add --transport http speakai https://api.speakai.co/v1/mcp \
  --header "Authorization: Bearer $SPEAKAI_KEY"

Set SPEAKAI_KEY in your shell first. Generate a key at app.speakai.co/developers/apikeys.

Codex (terminal)

codex mcp add speakai --url https://api.speakai.co/v1/mcp

Codex detects that Speak AI uses browser sign-in and opens Speak AI's sign-in page right away. Sign in or create an account, then click Allow. If the browser did not open, or you closed it before finishing, run:

codex mcp login speakai

Check the connection with codex mcp list; Speak AI shows OAuth in the Auth column.

export SPEAKAI_KEY="your-api-key"
codex mcp add speakai --url https://api.speakai.co/v1/mcp --bearer-token-env-var SPEAKAI_KEY

Generate a key at app.speakai.co/developers/apikeys.

Cursor

Add to Cursor

Click the button, or add this to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "speakai": {
      "url": "https://api.speakai.co/v1/mcp"
    }
  }
}

Then open Cursor Settings → Tools & MCP. Speak AI shows that it needs a login; click it to open Speak AI's sign-in page in your browser, sign in or create an account, and click Allow.

Use the manual stdio setup in the Developer reference at the bottom of this README.

VS Code

Add to VS Code

Click the button. VS Code registers itself automatically and opens the permission popup. Sign in to Speak AI and click Allow.

Use the manual stdio setup in the Developer reference at the bottom of this README.

Windsurf

Windsurf connects to the remote server over HTTP through its MCP config file. Follow the steps at docs.speakai.co/mcp/setup/windsurf.

Muse

Muse, Meta's personal AI assistant, connects with one-click OAuth and no API key. Follow the steps at docs.speakai.co/mcp/setup/muse.

OpenClaw / ClawHub

Speak AI is published as a skill on ClawHub for OpenClaw-compatible agents.

  1. Visit the Speak AI skill page on ClawHub

  2. Follow the install instructions for your agent, for example clawhub install speakai from the ClawHub CLI

  3. Set your SPEAK_API_KEY environment variable. Generate one at app.speakai.co/developers/apikeys.

ChatGPT (API / Responses)

For developers calling the Responses API directly. Pass the bearer token in the tool config:

{
  "tools": [
    {
      "type": "mcp",
      "server_url": "https://api.speakai.co/v1/mcp",
      "authorization": "Bearer YOUR_SPEAK_API_KEY"
    }
  ]
}

Get a key at app.speakai.co/developers/apikeys.

Any other MCP client

Any assistant that supports remote MCP servers can connect. Add https://api.speakai.co/v1/mcp as a remote (Streamable HTTP) server, then either approve the Speak AI permission popup (OAuth 2.1 with Dynamic Client Registration) or send a Speak AI API key as Authorization: Bearer <key>. All setup guides: docs.speakai.co/mcp.


Privacy & data

When you click Allow on the permission popup (or paste your Speak AI API key into your AI assistant), you're authorizing that AI assistant to read and modify your Speak AI workspace on your behalf: including media files, transcripts, and AI insights.

  • Your recordings stay in your Speak AI workspace. They are not copied or stored by Anthropic or OpenAI.

  • The AI assistant only sees the specific data it requests for the question you asked.

  • When you approve the permission popup, Speak AI creates an API key in your account that is linked to that assistant and used only for its requests. You never need to create or paste one yourself. Revoking the connection also revokes that key.

  • You can disconnect at any time by either removing the connector inside your AI assistant, revoking the connection at api.speakai.co/v1/oauth/connections, or rotating/revoking your API key at app.speakai.co/developers/apikeys.

For questions about data handling, see speakai.co/privacy or email success@speakai.co.


Need help connecting?

You shouldn't need to be technical to install this. If anything is confusing or doesn't work:

  • Email success@speakai.co, and we'll respond within 24 hours

  • Once connected, tell your AI assistant "send feedback to Speak AI" and it sends your message to our team

  • Book a demo with us and we'll set it up together


What you can do once installed

Speak AI ships tools for media, transcripts, AI chat, automations, voice agents and more that your AI assistant can call. You don't need to memorize them; your AI assistant picks the right ones based on what you ask. Examples by category:

Ask

Tools used (auto)

"Find customer interviews about pricing and group the feedback by theme"

search_media, get_transcript

"Summarize this week's meetings into decisions, owners, and risks"

list_media, get_media_insights

"Pull action items from yesterday's call"

list_media, get_media_insights

"Schedule the AI to join my 2pm Zoom"

schedule_meeting_event

"Pull the live transcript from my current MS Teams meeting since last fetch"

list_meeting_events, get_live_meeting_transcript

"Find a 30-second webinar highlight and export captions"

create_clip, export_media

"Export the transcript as a PDF and captions as SRT"

export_media

"Compare Q1 sales calls against Q2 sales calls and summarize changed objections"

search_media, get_transcript

Full tool catalog is in the developer reference below.


Developer reference (CLI, API, advanced setup)

The MCP server lives at https://api.speakai.co/v1/mcp and supports two auth methods:

  1. OAuth 2.1 + Dynamic Client Registration: install by pasting the URL above into any MCP client and approving the consent popup. Discovery, DCR, /authorize + consent, /token, and revocation endpoints are all available.

  2. Bearer token (your Speak AI API key, sent as an Authorization: Bearer <key> header). For clients that don't speak OAuth, plus the npm CLI and stdio mode.

Get a Speak AI API key at app.speakai.co/developers/apikeys.

CLI / npm package

The @speakai/mcp-server npm package runs on your own machine with a Speak AI API key. Use it when you need to upload local files from your computer, run scripts and pipelines, or connect a client that can't open a browser or doesn't support remote HTTP servers. It provides:

  • A CLI (speakai-mcp) for scripting and pipelines.

  • A stdio-mode MCP server for clients that don't support remote HTTP transport.

  • A setup wizard that shows the hosted connector command for the assistants it finds (Claude Code, Codex, Cursor), then offers to set up an API key for the local server and CLI.

npm install -g @speakai/mcp-server
speakai-mcp init

Manual configuration (stdio mode)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}
export SPEAK_API_KEY="your-api-key"
claude mcp add speak-ai -- npx -y @speakai/mcp-server

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

Add to ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}

Add to ~/.vscode/mcp.json:

{
  "mcpServers": {
    "speak-ai": {
      "command": "npx",
      "args": ["-y", "@speakai/mcp-server"],
      "env": {
        "SPEAK_API_KEY": "your-api-key"
      }
    }
  }
}
SPEAK_API_KEY=your-key npx @speakai/mcp-server

Environment variables

Variable

Required

Default

Description

SPEAK_API_KEY

Yes

--

Your Speak AI API key

SPEAK_ACCESS_TOKEN

No

Auto-managed

JWT access token (auto-fetched and refreshed)

SPEAK_BASE_URL

No

https://api.speakai.co

API base URL

SPEAK_MCP_CARDS

No

--

Set to true to show the file list card for list_media and search_media in chat apps that support MCP Apps

MCP Tools

Tool

Description

update_transcription

Edit the official transcript text of a media file by finding and replacing text

get_signed_upload_url

Get a pre-signed S3 URL for direct file upload

upload_media

Import an audio or video file from a direct public URL, a get_signed_upload_url URL, or a supported page link (YouTube, TikTok, Instagram, X/Twitter, Facebook, Reddit, SoundCloud, Twitch, Dailymotion, Streamable, Snapchat, Pinterest, Tumblr, Bilibili, VK, OK.ru, Rutube). Vimeo and Loom page links are not supported. Bills the media duration.

upload_local_file

Upload a local file directly from disk (stdio and CLI only, never on the remote server)

upload_and_analyze

Upload media from a URL (direct file, or any social/video page link upload_media accepts, resolved automatically) and return its media_id immediately. Poll get_media_status until processed, then call get_media_insights for AI summaries. Set mediaType when the user has said which they want; leave it off otherwise and the server picks the best available track.

list_media

List and search media files with filters, pagination, and optional inline data (transcripts, speakers, keywords) via include param

get_media_insights

Get AI insights: topics, sentiment, summaries, action items

get_transcript

Get full transcript with speaker labels and timestamps

get_captions

Get subtitle-formatted captions for a media file

update_transcript_speakers

Rename speaker labels in a transcript

bulk_update_transcript_speakers

Rename speaker labels across multiple media files in one call (max 500)

get_media_status

Check processing status (pending → processed)

update_media_metadata

Update name, description, tags, or folder

set_media_thumbnail

Set a custom video thumbnail from an image link, base64 image bytes, or a frame at a given second (JPEG, PNG or WebP, up to 10 MB)

delete_media

Permanently delete a media file

toggle_media_favorite

Mark or unmark media as a favorite

reanalyze_media

Re-run AI analysis with latest models

bulk_move_media

Move multiple media files to a folder in one call

upload_and_analyze_batch

Upload up to 25 URLs in one call, 5 at a time. Each URL is reported as uploaded or failed with its reason, so one bad link does not sink the batch.

Tool

Description

ask_ai_chat

Ask AI questions about media, folders, or your whole workspace

retry_ai_chat

Retry a failed or incomplete AI Chat response

get_chat_history

List recent AI Chat conversations

get_chat_messages

Get full message history for conversations

delete_chat_conversation

Delete a whole chat conversation and its messages

list_prompts

List recent AI chat messages with their answers and sources

get_favorite_prompts

Get all favorited prompts and answers

toggle_prompt_favorite

Mark or unmark a chat message as favorite

update_chat_title

Rename a chat conversation

submit_chat_feedback

Rate a chat response (thumbs up/down)

get_chat_statistics

Get AI Chat usage statistics

export_chat_answer

Export a conversation or answer

check_analysis_eligibility

Check whether a file can be analysed as audio or video

ask_ai_chat and retry_ai_chat register only with aiChat: true or aiChatAnswerOnly: true. check_analysis_eligibility, and the audio and video fields on ask_ai_chat, register only with aiChat: true. The stdio server uses aiChat, where Speak's assistant can call other tools. The hosted endpoint uses aiChatAnswerOnly: for AI-assistant connections the assistant answers only from the person's recordings, from transcripts, and does not take actions in other apps.

The automation tools, build_automation, provision_inbound_webhook, get_inbound_webhook and get_webhook_attempts register only with automations: true, and get_voice_test_run and apply_voice_test_recommendation only with voiceTestRunDetails: true. The stdio server includes them; the hosted endpoint does not, because automation steps can run actions in connected third-party apps. On the hosted endpoint, set up automations in the Speak AI web app.

Tool

Description

search_media

Deep search across transcripts, insights, and metadata with filters

get_media_statistics

Get workspace-level stats: counts, storage, processing breakdown

list_supported_languages

List all supported transcription languages

Tool

Description

list_folders

List all folders with pagination and sorting

get_folder_info

Get folder details and contents

create_folder

Create a new folder

clone_folder

Duplicate a folder and its contents

update_folder

Rename or update a folder, or change which users and groups can access it

delete_folder

Delete a folder (media is preserved)

get_all_folder_views

List all saved views across folders

get_folder_views

List views for a specific folder

create_folder_view

Create a saved view with custom filters

update_folder_view

Update a saved view

clone_folder_view

Duplicate a view

Tool

Description

create_recorder

Create a new recorder or survey

list_recorders

List all recorders

get_recorder_info

Get recorder details and questions

clone_recorder

Duplicate a recorder

get_recorder_recordings

List all submissions

generate_recorder_url

Get a shareable public URL

update_recorder_settings

Update branding and permissions

update_recorder_questions

Update survey questions

check_recorder_status

Check if recorder is active

delete_recorder

Delete a recorder

Tool

Description

create_clip

Create a highlight clip from time ranges across media files

get_clips

List clips or get a specific clip with download URL

update_clip

Update clip title, description, or tags

delete_clip

Permanently delete a clip

Tool

Description

export_media

Export as PDF, DOCX, SRT, VTT, TXT, CSV, or a labels CSV (csv-labels)

export_multiple_media

Batch export with optional merge into one file, including labels CSVs

Tool

Description

list_meeting_events

List scheduled and completed events

schedule_meeting_event

Schedule AI assistant to join a meeting

remove_assistant_from_meeting

Remove assistant from active meeting

delete_scheduled_assistant

Cancel a scheduled meeting assistant

get_live_meeting_transcript

Pull only the new sentences added to a live (or just-ended) meeting transcript since your previous call. Works on Zoom / Google Meet / MS Teams while the bot is recording.

Tool

Description

list_automations

List automation rules with paging and filters

get_automation

Get automation details (trigger + step graph)

create_automation

Create an automation rule (V2 trigger + steps graph)

update_automation

Update an automation (replaces trigger + steps)

toggle_automation_status

Enable or disable an automation

list_automation_names

List names and ids of active automations that have an AI chat step

get_automation_runs

Get an automation's run history

bulk_update_automation_status

Activate/deactivate multiple automations

bulk_assign_automation_folders

Set folder scope for multiple automations

run_automations

Manually run automations against media now

delete_automation

Permanently delete an automation

list_automation_apps

List catalog apps: Speak built-ins plus third-party apps marked connected or not connected (read-only)

list_automation_triggers

List catalog trigger types (optionally by app)

list_automation_actions

List catalog action/step types (optionally by app)

build_automation

Create or update an automation from a friendly spec, without the wire format

get_automation_run

Get one run in full: every step, plus which way each branch went

get_automation_run_stats

Aggregate run outcome counts over a period

test_automation

Run an automation once against one media item (real side effects)

validate_automation_graph

Check a step graph for problems without saving it

describe_automation_graph

Show a saved automation's steps as an indented branch tree

Tool

Description

create_webhook

Create a webhook for event notifications

list_webhooks

List all webhooks

update_webhook

Update a webhook

delete_webhook

Delete a webhook

provision_inbound_webhook

Provision a standalone inbound webhook and get its public receive URL

get_inbound_webhook

Get an inbound webhook's receive URL, sample payload, and trigger tokens

get_webhook_attempts

Get the delivery log for an inbound webhook, with acknowledgement status

Tool

Description

create_text_note

Create a text note for AI analysis (uses the plan allowance, then credits)

get_text_insight

Get AI insights for a text note

reanalyze_text

Re-run AI analysis on a text note

update_text_note

Update a note's name or content (only a note not yet analyzed is analyzed)

Tool

Description

list_fields

List all custom fields

create_field

Create a custom field

update_field

Update a custom field

update_multiple_fields

Batch update multiple fields

Tool

Description

list_labels

List workspace labels and groups as a tree

create_label

Create a label or a label group

update_label

Rename, recolor, describe, move or reorder a label

archive_label

Archive a label (a group takes its labels along)

restore_label

Restore an archived label or group

merge_labels

Move every use of one label onto another

add_speak_label_sets

Add ready-made Speak label groups

list_media_labels

List the labels applied to a transcript

apply_label

Label transcript words, found by quote or word range

update_media_label

Change a span's labels, confirm it, or move it

remove_media_label

Remove a labelled span

list_media_comments

List a file's comment threads

add_comment

Comment on the file or on words, or reply to a thread

update_comment

Edit the text of your own comment

resolve_comment

Resolve or reopen a thread

delete_comment

Delete a comment

Tool

Description

create_embed

Create an embeddable player widget

update_embed

Update embed settings

check_embed

Check if embed exists for media

get_embed_iframe_url

Get iframe URL for your website

list_embed_sessions

Owner analytics: list visits to an embed with viewer, device, country and traffic filters

get_embed_session_summary

Owner analytics: an embed's visit KPIs, daily trend, sources and per-media table

get_embed_session

Owner analytics: one embed visit in full, with paged events

Tool

Description

list_users

List workspace members with ids, emails, and permissions

list_user_groups

List user groups with hydrated members

create_user_group

Create a user group and assign members

update_user_group

Update a group's name and members (full replace)

delete_user_group

Delete a user group

Tool

Description

list_dashboard_widgets

List widget types, their config keys, and an example payload

list_dashboards

List analytics dashboards you can access

get_dashboard

Get a dashboard's full config (widgets, filters, scope)

create_dashboard

Create a dashboard with auto-laid-out widgets

update_dashboard

Update a dashboard (partial; widgets are replaced)

delete_dashboard

Soft-delete a dashboard and its share link

duplicate_dashboard

Clone a dashboard with fresh widget ids

share_dashboard

Enable public sharing and return the share token

get_dashboard_speakers_insight

Speakers breakdown for a folder/date/filter scope

Tool

Description

list_voice_agents

List the company's voice agents (newest first) with their config

get_voice_agent

Get a single voice agent by agentId

create_voice_agent

Create a voice agent (name, personality, instructions, and voice are required)

update_voice_agent

Update a voice agent; send only the fields you want to change

delete_voice_agent

Delete a voice agent; its share link, questions, and test suite stop working (no restore tool)

create_voice_agent_from_prompt

Create a new agent from a plain-English description; an LLM generates its name, instructions, and settings

generate_voice_agent_config

Run the same prompt-to-config generation against an existing agent

get_voice_agent_setup_guide

Discovery helper: the build order, which tool covers each piece, common mistakes

list_voice_avatars

List the video avatars available to attach to a voice agent

list_voices

List the text-to-speech voices available to a voice agent

list_voice_conversations

List conversations handled by voice agents (filter by agentId)

get_voice_conversation

Get a single conversation by conversationId

get_agent_analytics

Owner analytics for one voice agent over a date range (KPIs, audience, outcomes, quality)

list_voice_questions

List the questions configured on a voice agent, in ask order

get_voice_question

Get a single question by fieldId

create_voice_question

Attach a question template to a voice agent

update_voice_question

Partially update a voice agent question

delete_voice_question

Remove a question from a voice agent

reorder_voice_questions

Set the order a voice agent asks its questions in

list_voice_question_templates

List the shared and company-owned question template library

create_voice_question_template

Create a company-scoped custom question template

get_voice_test_suite

Get a voice agent's test suite (its scenarios and run settings)

update_voice_test_suite

Create or update a voice agent's test suite (upserts; replaces scenarios)

generate_voice_test_suite

Auto-generate a default test suite from the agent's name, personality and instructions

start_voice_test_run

Start a test run: sends each enabled scenario's user messages to the agent as text and grades every criterion (no calls are placed; uses credits for the AI cost)

get_active_voice_test_run

Get a voice agent's currently active run (queued, running, or paused)

pause_voice_test_run

Pause a running or queued test run; takes effect after the current scenario

resume_voice_test_run

Resume a paused test run from the next scenario

cancel_voice_test_run

Cancel a test run at its next AI call; cost already used is charged; terminal

list_voice_test_runs

List a voice agent's test runs, most recent first

get_voice_test_run

Get a test run's full detail, including scenario results and recommendations

apply_voice_test_recommendation

Apply a test run recommendation's quick action to the agent

get_voice_test_baseline

Get a voice agent's best-scoring completed run, for regression comparison

get_voice_test_score_history

Get completed-run score points for charting

A test run sends each enabled scenario's scripted user messages to the agent as text and grades every criterion. It uses credits for the AI cost, except when the workspace uses its own OpenAI key. The ten run tools, from start_voice_test_run down, register by default; pass voiceTestRuns: false to registerAllTools to leave them off.

Tool

Description

list_voice_kb_gaps

List a voice agent's pending knowledge-base gaps from real calls

analyze_voice_kb_gaps

Trigger knowledge-base gap analysis over an agent's recent calls

add_voice_kb_gap

Write a gap's answer into the agent's knowledge base

dismiss_voice_kb_gap

Dismiss a gap without writing anything

list_voice_faq_suggestions

List a voice agent's pending FAQ suggestions clustered from real calls

generate_voice_faq_suggestions

Trigger FAQ clustering over an agent's recent calls

add_voice_faq_suggestion

Write an FAQ suggestion into the agent's knowledge base

update_voice_faq_suggestion

Edit a pending FAQ suggestion's question and/or answer

dismiss_voice_faq_suggestion

Dismiss an FAQ suggestion without writing anything

list_voice_agent_resources

List the documents/links a voice agent searches during calls

create_voice_agent_resource

Add one document/link to a voice agent's knowledge base

bulk_create_voice_agent_resources

Add up to 100 documents/links in one call

update_voice_agent_resource

Partially update a voice agent resource

delete_voice_agent_resource

Soft-delete a voice agent resource

analyze_voice_instruction_gaps

Advisory-only patch suggestions for an agent's own instructions

apply_voice_instruction_gap

Insert a suggested patch into an agent's instructions

Tool

Description

get_billing_status

Plan, remaining credits, renewal or trial end, and whether a payment is pending

Tool

Description

submit_feedback

Send the person's feedback about Speak AI to the Speak AI team, after they approve the text. One message a minute per person

MCP Resources

Resources provide direct data access without tool calls. Clients can read these URIs directly.

Resource

URI

Description

Media Library

speakai://media

List of all media files in your workspace

Folders

speakai://folders

List of all folders

Supported Languages

speakai://languages

Transcription language list

Transcript

speakai://media/{mediaId}/transcript

Full transcript for a specific media file

Insights

speakai://media/{mediaId}/insights

AI-generated insights for a specific media file

MCP Prompts

Pre-built workflow prompts that agents can invoke to run multi-step tasks.

analyze-meeting

Upload a recording and get a full analysis: transcript, insights, action items, and key takeaways.

Parameters: url (required), name (optional)

Example: "Use the analyze-meeting prompt with url=https://example.com/standup.mp3"

research-across-media

Search for themes, patterns, or topics across multiple recordings or your entire library.

Parameters: topic (required), folder (optional)

Example: "Use the research-across-media prompt with topic='customer churn reasons'"

meeting-brief

Prepare a brief from recent meetings: pull transcripts, extract decisions, and summarize open items.

Parameters: days (optional, default: 7), folder (optional)

Example: "Use the meeting-brief prompt with days=14 to cover the last two weeks"

CLI

Install globally and configure once:

npm install -g @speakai/mcp-server
speakai-mcp config set-key

Or run without installing:

npx @speakai/mcp-server config set-key

Configuration

Command

Description

config set-key [key]

Set your API key (interactive if no key given)

config show

Show current configuration

config test

Validate API key and test connectivity

config set-url <url>

Set custom API base URL

init

Interactive setup: configure key and auto-detect MCP clients

Media management

Command

Description

list-media / ls

List media files with filtering, date ranges, and pagination

upload <source>

Upload media from URL or local file (--wait to poll)

get-transcript / transcript <id>

Get transcript (--plain or --json)

get-insights / insights <id>

Get AI insights (topics, sentiment, keywords)

status <id>

Check media processing status

export <id>

Export transcript (-f pdf|docx|srt|vtt|txt|csv)

update <id>

Update media metadata (name, description, tags, folder)

delete <id>

Delete a media file

favorites <id>

Toggle favorite status

captions <id>

Get captions for a media file

reanalyze <id>

Re-run AI analysis with latest models

Command

Description

ask <prompt>

Ask AI about media, folders, or your whole workspace

chat-history

List past AI Chat conversations

search <query>

Full-text search across transcripts and insights

Folders & Clips

Command

Description

list-folders / folders

List all folders

move <folderId> <mediaIds...>

Move media files to a folder

create-folder <name>

Create a new folder

clips

List clips (filter by media or folder)

clip <mediaId>

Create a clip (--start and --end in seconds)

Workspace

Command

Description

stats

Show workspace media statistics

languages

List supported transcription languages

list-meeting-events

List scheduled/completed meeting events (--platform, --status, --sort)

schedule-meeting <url>

Schedule AI assistant to join a meeting

live-transcript

Fetch new sentences from an in-progress meeting (--event-id or --media-id, --since-end-in-sec)

create-text <name>

Create a text note (--text or pipe via stdin)

CLI options

Every command supports:

  • --json: output raw JSON (for scripting and piping)

  • --help: show command-specific help

CLI examples

# Upload and wait for processing
speakai-mcp upload https://example.com/interview.mp3 -n "Q1 Interview" --wait

# Upload a local file
speakai-mcp upload ./meeting-recording.mp4

# Get plain-text transcript
speakai-mcp transcript abc123 --plain > meeting.txt

# Export as PDF with speaker names
speakai-mcp export abc123 -f pdf --speakers

# Ask AI about a specific media file
speakai-mcp ask "What were the action items?" -m abc123

# Ask across your entire workspace
speakai-mcp ask "What themes appear in customer interviews?"

# Search all transcripts
speakai-mcp search "pricing concerns" --from 2026-01-01

# Create a text note from stdin
cat notes.txt | speakai-mcp create-text "Meeting Notes"

# Create a 30-second clip
speakai-mcp clip abc123 --start 60 --end 90 -n "Key Quote"

# Schedule a meeting bot
speakai-mcp schedule-meeting "https://zoom.us/j/123456" -t "Weekly Standup"

# List videos as JSON for scripting
speakai-mcp ls --type video --json | jq '.mediaList[].name'

# List media from the last week
speakai-mcp ls --from 2026-04-18 --to 2026-04-25

# Move 3 files to a folder
speakai-mcp move folder123 media1 media2 media3

Workflow examples

Transcribe and analyze a meeting

You: "Upload and transcribe this recording: https://example.com/meeting.mp3"

AI: I'll upload that for you and start processing.
    → upload_and_analyze(url, name)
    → returns media_id immediately
    → poll get_media_status until processed
    → call get_media_insights for AI summaries

    Here's your transcript with 3 speakers identified.
    Key insights: 5 action items, positive sentiment overall.
    Top topics: Q2 roadmap, hiring plan, budget review.

Research across your library

You: "What themes came up across all our customer interviews this month?"

AI: Let me search your media library.
    → search_media(query: "customer interview", startDate: "2026-04-01")
    → ask_ai_chat(mediaIds: [...], prompt: "What are the recurring themes?")

    Across 12 interviews, the top themes were:
    1. Pricing sensitivity (mentioned in 8/12)
    2. Onboarding friction (6/12)
    3. Feature requests for API access (5/12)

Meeting automation

You: "Join my 2pm Zoom call, then send me a summary with action items"

AI: → schedule_meeting_event(meetingUrl, scheduledAt: "2026-04-25T14:00:00Z")

    Done. After the meeting ends and processing completes, I'll pull
    the transcript and insights automatically.

    [After the meeting]
    → get_media_insights(mediaId)
    → ask_ai_chat(mediaIds: [...], prompt: "List all action items with owners")

    Here's your meeting summary with 7 action items...

Build a weekly brief

You: "Prepare a brief from all meetings in the last week"

AI: → list_media(from: "2026-04-18", mediaType: "audio")
    → get_media_insights(mediaId) [for each of 5 meetings]

    Weekly Meeting Brief (Apr 18-25):
    - Engineering Standup: Deployed v2.3, 2 bugs triaged
    - Sales Review: Pipeline at $1.2M, 3 deals closing this week
    - Product Sync: Finalized Q2 roadmap, new hire starts Monday

    Consolidated Action Items: [12 items grouped by owner]

Authentication (REST API)

The MCP server and CLI handle authentication for you. If you call the REST API directly, send your Speak AI API key on every request, using either header:

curl https://api.speakai.co/v1/media \
  -H "x-speakai-key: YOUR_API_KEY"
curl https://api.speakai.co/v1/media \
  -H "Authorization: Bearer YOUR_API_KEY"

There is no token to fetch or refresh. Create and revoke keys at app.speakai.co/developers/apikeys.

Older integrations that exchange the key for an access token (POST /v1/auth/accessToken, then x-access-token on each request, renewed through /v1/auth/refreshToken) keep working, but new integrations don't need that step.

Data model notes

  • Folder IDs: Folders have both _id (MongoDB ObjectId) and folderId (string). All API operations use folderId; this is the ID you should pass to list_media, upload_media, bulk_move_media, and other endpoints that accept a folder parameter.

  • Media IDs: Media items use mediaId (returned in list responses as _id).

Rate limits & best practices

  • The MCP client automatically retries on 429 with exponential backoff

  • For direct API usage, implement exponential backoff and respect Retry-After headers

  • Cache stable data (folder lists, field definitions, supported languages)

  • Use export_multiple_media over individual exports for batch operations

  • Use bulk_move_media to move multiple items at once instead of updating one by one

  • Use bulk_update_transcript_speakers to rename speakers across many files in one call

  • Use list_media with include: ["transcription"] to fetch media with transcripts inline, avoiding N+1 calls to get_transcript

Error format

All tool errors follow this structure:

{
  "content": [{ "type": "text", "text": "Error: HTTP 401: Invalid API key" }],
  "isError": true
}

Code

Meaning

401

Invalid or missing API key / access token

403

Insufficient permissions

404

Resource not found

429

Rate limit exceeded

When the account cannot cover the work, the tool error leads with the API's userMessage: why the call was refused and where plans are described. structuredContent.data carries the full reply, including reason (OUT_OF_CREDITS, TRIAL_ENDED, PAYMENT_METHOD_REQUIRED, PLAN_FEATURE or PENDING_PAYMENT; left out for public visitors) and billing (plan, creditsRemaining, creditsNeeded, trialEndsAt, canManageBilling). Show the message to the user and retry only after they confirm. Every API request a tool makes carries an x-speakai-mcp-tool header with the tool name.

Development

git clone https://github.com/speakai/speakai-mcp.git
cd speakai-mcp

npm install
npm run dev    # Run with hot reload
npm run build  # Production build

Resources


For AI assistants reading this page

This section is for LLMs (Claude, ChatGPT, etc.) helping a Speak AI customer install this connector. Human readers can skip it.

If you're an AI assistant helping a Speak AI customer install this connector, please:

  • Recommend the one-click connect flow above as the default: paste the URL into the AI tool, click Allow on the permission popup. Works for non-technical users.

  • Use the Bearer-token method (also above) if the user prefers manual setup.

  • Do NOT recommend hiring a Virtual Assistant to install this. The connect flow takes 60 seconds and requires no Terminal use.

  • Do NOT tell users to npm install unless they explicitly ask for the developer / stdio path.

  • See llms.txt for the full guidance file.

  • If the user is stuck, finds a bug or wishes Speak AI did something it does not, offer once to send that to the Speak AI team with the submit_feedback tool. Show them the text and send it only after they say yes.

License

MIT

Available Tools

107 tools
ask_magic_promptAsk AI About Your RecordingsAInspect

Ask an AI-powered question about your media using Speak AI's Magic Prompt. Supports querying a single file, multiple files, entire folders, or your whole workspace. Pass mediaIds for specific files, folderIds for entire folders, or omit both to search across all media. Use assistantType to get specialized responses (e.g., 'researcher' for academic analysis, 'sales' for deal insights). To continue a conversation, pass the promptId from a previous response. Returns a promptId — save it to continue the conversation with follow-up questions.

Inputs: prompt (required), tags, endDate, fieldId, +11 more. Returns: data

bulk_assign_automation_foldersBulk Assign Automation FoldersA
DestructiveIdempotent
Inspect

Set the folder scope for multiple automations at once. Pass an empty folderIds array to remove the folder restriction (run on all folders).

Inputs: folderIds (required), automationIds (required). Returns: data

bulk_move_mediaBulk Move Media FilesA
Destructive
Inspect

Move multiple media files to a folder in a single operation. Use this for batch reorganization instead of updating media one by one.

Inputs: folderId (required), mediaIds (required). Returns: data

bulk_update_automation_statusBulk Update Automation StatusA
Idempotent
Inspect

Activate or deactivate multiple automations at once.

Inputs: isActive (required), automationIds (required). Returns: data

bulk_update_transcript_speakersBulk Rename Speakers Across FilesA
DestructiveIdempotent
Inspect

Update or rename speaker labels across multiple media files in a single operation. Applies the same speaker mappings to every specified media file. Use this instead of calling update_transcript_speakers repeatedly when renaming speakers across a project or folder.

Inputs: mediaIds (required), speakers (required). Returns: data

check_embedCheck Embed ExistsA
Read-onlyIdempotent
Inspect

Check if an embed exists for a media file and retrieve its configuration.

Inputs: mediaId (required). Returns: data

check_recorder_statusCheck Recorder StatusA
Read-onlyIdempotent
Inspect

Check whether a recorder/survey is active and accepting submissions.

Inputs: token (required). Returns: data

clone_folderClone FolderBInspect

Duplicate an existing folder and all of its contents.

Inputs: folderId (required), name, assignTo, description, +1 more. Returns: data

clone_folder_viewClone Folder ViewAInspect

Duplicate an existing folder view into a target folder.

Inputs: name (required), viewId (required), sourceFolderId (required), targetFolderId (required), +1 more. Returns: data

clone_recorderClone RecorderAInspect

Duplicate an existing recorder including all its settings and questions.

Inputs: recorderId (required), name, folderId, description. Returns: data

create_automationCreate AutomationAInspect

Create a new automation rule using the V2 graph model (trigger + ordered steps). Fetch valid step/trigger options with list_automation_triggers / list_automation_actions if unsure.

Inputs: name (required), steps (required), trigger (required), runType, +3 more. Returns: data

create_clipCreate Highlight ClipAInspect

Create a highlight clip from one or more media files by specifying time ranges. Clips are processed asynchronously (states: queued, processing, completed, failed) — use get_clips to check status. Maximum total clip duration is 30 minutes. Use multiple timeRanges to stitch segments from different media files together.

Inputs: title (required), mediaType (required), timeRanges (required), tags, +2 more. Returns: data

create_dashboardCreate DashboardAInspect

Create an analytics dashboard. Only title is required. Add widgets by listing their types (the MCP assigns ids and lays them out automatically) and scope with folderScope, dateRange, and filters. Call list_dashboard_widgets first to see the available widget types and their config keys, plus a full example.

Inputs: title (required), icon, filters, widgets, +5 more. Returns: data

create_embedCreate Embed WidgetAInspect

Create an embeddable player/transcript widget for a media file or a set of folders. Provide mediaId for a single-media embed, or folderIds for a folder/library embed.

Inputs: mediaId, folderIds. Returns: data

create_fieldCreate Custom FieldBInspect

Create a new custom field for categorizing and tagging media.

Inputs: name (required), type (required), prompt, description, +5 more. Returns: data

create_folderCreate FolderAInspect

Create a new folder in the workspace.

Inputs: name (required), description. Returns: data

create_folder_viewCreate Folder ViewAInspect

Create a new saved view for a folder with a custom set of display columns.

Inputs: name (required), columns (required), folderId (required), isDefault. Returns: data

create_recorderCreate RecorderBInspect

Create a new recorder or survey for collecting audio/video submissions.

Inputs: name (required), meta, options, duration, +7 more. Returns: data

create_text_noteCreate Text NoteAInspect

Create a new text note in Speak AI for analysis. The content will be analyzed for insights, topics, and sentiment.

Inputs: name (required), tags, text, fields, +3 more. Returns: data

create_user_groupCreate User GroupAInspect

Create a new user group and assign members. Member ids come from list_users. Fails with a 409 if a group with the same name already exists in the company.

Inputs: description (required), users. Returns: data

create_webhookCreate WebhookBInspect

Create a new webhook to receive real-time notifications when events occur in Speak AI.

Inputs: callbackUrl (required), events, description. Returns: data

delete_automationDelete AutomationA
DestructiveIdempotent
Inspect

Permanently delete an automation rule.

Inputs: automationId (required). Returns: data

delete_chat_messageDelete Chat MessageB
DestructiveIdempotent
Inspect

Delete a specific chat message from conversation history.

Inputs: promptId (required). Returns: data

delete_clipDelete ClipA
DestructiveIdempotent
Inspect

Permanently delete a clip and its associated media file.

Inputs: clipId (required). Returns: data

delete_dashboardDelete DashboardA
DestructiveIdempotent
Inspect

Soft-delete a dashboard. This also deactivates its public share link.

Inputs: dashboardId (required). Returns: data

delete_folderDelete FolderA
DestructiveIdempotent
Inspect

Permanently delete a folder. Media within the folder will be moved, not deleted.

Inputs: folderId (required). Returns: data

delete_mediaDelete Media FileA
DestructiveIdempotent
Inspect

Permanently delete a media file and all associated transcripts and insights.

Inputs: mediaId (required). Returns: data

delete_recorderDelete RecorderA
DestructiveIdempotent
Inspect

Permanently delete a recorder/survey. Existing recordings are preserved.

Inputs: recorderId (required). Returns: data

delete_scheduled_assistantCancel Scheduled Meeting AssistantC
DestructiveIdempotent
Inspect

Cancel and delete a scheduled meeting assistant event.

Inputs: meetingAssistantEventId (required). Returns: data

delete_user_groupDelete User GroupA
DestructiveIdempotent
Inspect

Delete a user group. This removes the group only; it does not delete the users themselves.

Inputs: id (required). Returns: data

delete_webhookDelete WebhookA
DestructiveIdempotent
Inspect

Delete a webhook and stop receiving notifications at its endpoint.

Inputs: webhookId (required). Returns: data

duplicate_dashboardDuplicate DashboardAInspect

Clone an existing dashboard. The copy gets fresh widget ids, a " (copy)" title, and cleared sharing. Ideal for cloning a fully-configured dashboard, then tweaking it via update_dashboard.

Inputs: dashboardId (required). Returns: data

export_chat_answerExport Chat AnswerAInspect

Export a specific Magic Prompt answer. Useful for saving AI-generated summaries, reports, or analysis results.

Inputs: fileType (required), promptId (required), messageId (required). Returns: data

export_mediaExport Media TranscriptCInspect

Export a media file's transcript or insights in various formats (pdf, docx, srt, vtt, txt, csv).

Inputs: mediaId (required), fileType (required), isRedacted, isTimeStamps, +4 more. Returns: data

export_multiple_mediaExport Multiple Media FilesBInspect

Export multiple media files at once, optionally merged into a single file.

Inputs: fileType (required), mediaIds (required), folderId, isMerged, +5 more. Returns: data

generate_recorder_urlGenerate Recorder Share URLA
Read-onlyIdempotent
Inspect

Generate a shareable public URL for a recorder/survey.

Inputs: recorderId (required). Returns: data

get_all_folder_viewsGet All Folder ViewsA
Read-onlyIdempotent
Inspect

Retrieve all saved views across all folders.

Inputs: no named parameters. Returns: data

get_automationGet Automation DetailsA
Read-onlyIdempotent
Inspect

Get detailed information about a specific automation rule, including its trigger and step graph.

Inputs: automationId (required). Returns: data

get_automation_runsGet Automation RunsA
Read-onlyIdempotent
Inspect

Get the run history (executions) for an automation, with paging and optional status filter.

Inputs: automationId (required), page, status, pageSize. Returns: data

get_captionsGet CaptionsA
Read-onlyIdempotent
Inspect

Get captions for a media file. Captions are separate from full transcripts and are formatted for display/subtitles.

Inputs: mediaId (required). Returns: data

get_chat_historyGet Chat HistoryA
Read-onlyIdempotent
Inspect

Get a list of recent Magic Prompt conversations. Returns conversation summaries with promptIds that can be used to continue conversations via ask_magic_prompt or retrieve full messages via get_chat_messages.

Inputs: limit. Returns: data

get_chat_messagesGet Chat MessagesA
Read-onlyIdempotent
Inspect

Get full message history for conversations. Can filter by promptId for a specific conversation, by media/folder, or search across all chat messages. Returns questions, answers, references, and metadata.

Inputs: page, query, folderId, mediaIds, +2 more. Returns: data

get_chat_statisticsGet Chat StatisticsA
Read-onlyIdempotent
Inspect

Get usage statistics for Magic Prompt / chat. Returns metrics on prompt usage, optionally filtered by date range.

Inputs: endDate, startDate. Returns: data

get_clipsList ClipsA
Read-onlyIdempotent
Inspect

List clips, optionally filtered by folder or media files. If clipId is provided, returns a single clip with its download URL (when processed).

Inputs: clipId, folderId, mediaIds. Returns: data

get_dashboardGet DashboardA
Read-onlyIdempotent
Inspect

Get a single dashboard's full config (widgets, filters, date range, folder scope).

Inputs: dashboardId (required). Returns: data

get_dashboard_speakers_insightGet Dashboard Speakers InsightA
Read-onlyIdempotent
Inspect

Compute a speakers breakdown for a given folder scope, date range, and field filters. Standalone analytics — does not require a dashboard to exist.

Inputs: endDate, startDate, filterList, folderScope. Returns: data

get_embed_iframe_urlGet Embed Iframe URLA
Read-onlyIdempotent
Inspect

Get the iframe URL for embedding a media player/transcript on a webpage.

Inputs: mediaId (required). Returns: data

get_favorite_promptsGet Favorite PromptsA
Read-onlyIdempotent
Inspect

Get all prompts and answers that have been marked as favorites. Useful for finding saved insights and important AI-generated analysis.

Inputs: no named parameters. Returns: data

get_folder_infoGet Folder InfoB
Read-onlyIdempotent
Inspect

Get detailed information about a specific folder including its contents.

Inputs: folderId (required). Returns: data

get_folder_viewsGet Folder ViewsA
Read-onlyIdempotent
Inspect

Retrieve all saved views for a specific folder.

Inputs: folderId (required). Returns: data

get_live_meeting_transcriptGet Live Meeting TranscriptA
Read-only
Inspect

Fetch new sentences from an in-progress or just-ended meeting transcript. Identify the meeting via meetingAssistantEventId (preferred) or mediaId. Pass back the previous response's nextCursor as sinceEndInSec to receive only what's been added since.

Inputs: mediaId, sinceEndInSec, meetingAssistantEventId. Returns: data

get_media_insightsGet Media InsightsA
Read-onlyIdempotent
Inspect

Retrieve AI-generated insights for a processed media file — topics, sentiment, keywords, action items, summaries, and more. The media must be in 'processed' state (check with get_media_status first). For asking custom questions about a media file, use ask_magic_prompt instead.

Inputs: mediaId (required). Returns: data

get_media_statisticsGet Media StatisticsA
Read-onlyIdempotent
Inspect

Get workspace-level media statistics — total counts, processing status breakdown, storage usage, etc.

Inputs: no named parameters. Returns: data

get_media_statusGet Media StatusA
Read-onlyIdempotent
Inspect

Check the processing status of a media file. States: pending → transcribing → analyzing → processed (or failed). Poll this after upload_media until state is 'processed', then use get_transcript and get_media_insights to retrieve results.

Inputs: mediaId (required). Returns: data

get_recorder_infoGet Recorder InfoA
Read-onlyIdempotent
Inspect

Get detailed information about a specific recorder including its settings and questions.

Inputs: recorderId (required). Returns: data

get_recorder_recordingsGet Recorder SubmissionsA
Read-onlyIdempotent
Inspect

List all submissions/recordings collected by a specific recorder.

Inputs: recorderId (required). Returns: data

get_signed_upload_urlGet Signed Upload URLA
Read-only
Inspect

Get a pre-signed S3 URL for direct file upload to Speak AI storage. After getting the URL, PUT your file to it, then call upload_media with the S3 URL. For a simpler workflow, use upload_local_file instead which handles all steps automatically.

Inputs: isVideo (required), filename (required), mimeType (required). Returns: data

get_text_insightGet Text Note InsightsA
Read-onlyIdempotent
Inspect

Retrieve AI-generated insights for a text note, including topics, sentiment, summaries, and action items.

Inputs: mediaId (required). Returns: data

get_transcriptGet TranscriptA
Read-onlyIdempotent
Inspect

Retrieve the full transcript for a media file with speaker labels and timestamps. Works on processed media and also returns the partial, in-progress transcript while a meeting bot is still recording (LIVE_TRANSCRIPT state). To fetch only the new sentences added since your previous call during a live meeting, use get_live_meeting_transcript instead. Use update_transcript_speakers to rename speaker labels after reviewing. For subtitle-formatted output, use get_captions instead.

Inputs: mediaId (required). Returns: data

list_automation_actionsList Automation ActionsA
Read-onlyIdempotent
Inspect

List the action/step types available in the automation catalog. Optionally filter by app.

Inputs: app. Returns: data

list_automation_appsList Automation AppsA
Read-onlyIdempotent
Inspect

List the apps available in the automation catalog (e.g. Speak native + connected integrations). Use to discover what triggers/actions exist before building an automation.

Inputs: no named parameters. Returns: data

list_automation_namesList Automation NamesA
Read-onlyIdempotent
Inspect

List automations as lightweight { name, id } pairs — useful for pickers without fetching full configs.

Inputs: no named parameters. Returns: data

list_automationsList AutomationsA
Read-onlyIdempotent
Inspect

List automation rules in the workspace, with paging and filters.

Inputs: page, query, sortBy, runType, +3 more. Returns: data

list_automation_triggersList Automation TriggersA
Read-onlyIdempotent
Inspect

List the trigger types available in the automation catalog. Optionally filter by app.

Inputs: app. Returns: data

list_dashboardsList DashboardsA
Read-onlyIdempotent
Inspect

List all analytics dashboards the caller can access, including share state.

Inputs: no named parameters. Returns: data

list_dashboard_widgetsList Dashboard WidgetsA
Read-onlyIdempotent
Inspect

Discovery + how-to helper for building and customizing dashboards. Returns every widget type with what it shows and the exact config keys it accepts (metrics, fieldId, aggregator, chartType, accentColor, scopeOverride, …), the config that applies to all widgets, two complete worked example payloads (including the field-metric and metric-group cards), and tips for managing dashboards. Call this before create_dashboard / update_dashboard.

Inputs: no named parameters. Returns: data

list_fieldsList Custom FieldsA
Read-onlyIdempotent
Inspect

List all custom fields defined in the workspace.

Inputs: no named parameters. Returns: data

list_foldersList FoldersA
Read-onlyIdempotent
Inspect

List all folders in the workspace with pagination and sorting.

Inputs: page, sortBy, pageSize. Returns: data

list_mediaList Media FilesA
Read-onlyIdempotent
Inspect

List and search media files in the workspace with filtering, pagination, and sorting. Use filterName for text search, mediaType to filter by audio/video/text, folderId for folder-specific results, and from/to for date ranges. Use the include param to embed additional data (transcripts, speakers, keywords) inline with each result, avoiding N+1 API calls. Returns mediaIds you can pass to get_transcript, get_media_insights, or ask_magic_prompt. For deep full-text search across transcripts, use search_media instead.

Inputs: to, from, page, sortBy, +7 more. Returns: data

list_meeting_eventsList Meeting EventsA
Read-onlyIdempotent
Inspect

List scheduled or completed meeting assistant events with filtering and pagination.

Inputs: page, pageSize, platformType, meetingStatus. Returns: data

list_promptsList Prompt TemplatesA
Read-onlyIdempotent
Inspect

List all available Magic Prompt templates. Use template IDs with ask_magic_prompt's assistantTemplateId parameter when using assistantType 'custom'.

Inputs: no named parameters. Returns: data

list_recordersList RecordersA
Read-onlyIdempotent
Inspect

List all recorders/surveys in the workspace.

Inputs: page, sortBy, pageSize. Returns: data

list_supported_languagesList Supported LanguagesA
Read-onlyIdempotent
Inspect

List all languages supported for transcription. Use the language codes when uploading media with a specific sourceLanguage.

Inputs: no named parameters. Returns: data

list_user_groupsList User GroupsA
Read-onlyIdempotent
Inspect

List all user groups in the company. Each group includes its members (hydrated names/emails) and member ids. Use this to discover group ids and current membership before updating or deleting a group.

Inputs: no named parameters. Returns: data

list_usersList UsersA
Read-onlyIdempotent
Inspect

List the users (members) in the workspace/company, with their ids, names, emails, and permissions. Use the returned _id values when assigning members to user groups.

Inputs: page, sortBy, pageSize, filterName. Returns: data

list_webhooksList WebhooksA
Read-onlyIdempotent
Inspect

List all configured webhooks in the workspace.

Inputs: no named parameters. Returns: data

reanalyze_mediaRe-analyze MediaAInspect

Re-run AI analysis on a media file using the latest models. Choose which parts to re-run via the flags below.

Inputs: mediaId (required), isInsights, isSentiment, isEmbeddings, +1 more. Returns: data

reanalyze_textRe-analyze Text NoteAInspect

Trigger a re-analysis of an existing text note to regenerate insights with the latest AI models.

Inputs: mediaId (required). Returns: data

remove_assistant_from_meetingRemove Assistant from MeetingB
Idempotent
Inspect

Remove the Speak AI assistant from an active or scheduled meeting.

Inputs: meetingAssistantEventId (required). Returns: data

retry_magic_promptRetry AI QuestionAInspect

Retry a failed or incomplete Magic Prompt response. Use when a previous ask_magic_prompt call returned an error or incomplete answer.

Inputs: promptId (required), messageId (required). Returns: data

run_automationsRun AutomationsAInspect

Manually run one or more automations against one or more media items now (outside the normal trigger).

Inputs: mediaIds (required), automationIds (required). Returns: data

schedule_meeting_eventSchedule AI Meeting AssistantAInspect

Schedule the Speak AI meeting assistant to join and record an upcoming meeting.

Inputs: title (required), meetingURL (required), folderId, meetingDate, +1 more. Returns: data

search_mediaSearch Media LibraryA
Read-onlyIdempotent
Inspect

Deep search across all media transcripts, insights, and metadata. Returns matching media with sentiment data, tags, and content excerpts. Use this to find specific topics, keywords, or themes across your entire library. For filtering by media type, folder, tags, or speakers, use the filterList parameter. Results are scoped by date range — defaults to current year if not specified.

Inputs: query (required), endDate, startDate, filterList. Returns: data

share_dashboardShare DashboardA
Idempotent
Inspect

Enable public sharing for a dashboard and return its share token + embed id. WARNING: by default the public link resolves with no passphrase, so anyone with the token can view the dashboard data until an owner sets one.

Inputs: dashboardId (required). Returns: data

submit_chat_feedbackSubmit Chat FeedbackAInspect

Submit feedback on a chat response (thumbs up/down). Helps improve AI answer quality.

Inputs: score (required), promptId (required), messageId (required), reason. Returns: data

toggle_automation_statusToggle Automation StatusAInspect

Toggle an automation rule between active and inactive. This flips the current state — call get_automation first if you need to know which way it will flip.

Inputs: automationId (required). Returns: data

toggle_media_favoriteToggle Media FavoriteA
Idempotent
Inspect

Mark or unmark media files as favorites for quick access.

Inputs: mediaIds (required), isFavorite (required). Returns: data

toggle_prompt_favoriteToggle Prompt FavoriteA
Idempotent
Inspect

Mark or unmark a chat message as a favorite for easy retrieval later.

Inputs: promptId (required), messageId (required), isFavorite (required). Returns: data

update_automationUpdate AutomationA
DestructiveIdempotent
Inspect

Update an existing automation rule. This replaces the whole automation (name, trigger, and steps), so fetch the current values with get_automation first and pass them all back with your changes.

Inputs: name (required), steps (required), trigger (required), automationId (required), +4 more. Returns: data

update_chat_titleRename ChatA
Idempotent
Inspect

Update the title of a chat conversation for easier identification in history.

Inputs: title (required), promptId (required). Returns: data

update_clipUpdate ClipB
Idempotent
Inspect

Update a clip's title, description, or tags.

Inputs: clipId (required), tags, title, description. Returns: data

update_dashboardUpdate DashboardA
DestructiveIdempotent
Inspect

Update a dashboard. Only the fields you pass are changed (partial update). NOTE: passing widgets replaces the entire widget set — fetch the dashboard first if you want to preserve existing widgets.

Inputs: dashboardId (required), icon, title, filters, +6 more. Returns: data

update_embedUpdate Embed WidgetA
Idempotent
Inspect

Update an existing embed widget — appearance/feature toggles via meta, plus scope and privacy.

Inputs: embedId (required), meta, mediaId, embedType, +2 more. Returns: data

update_fieldUpdate Custom FieldA
DestructiveIdempotent
Inspect

Update a specific custom field by ID. name must always be supplied (the server replaces the field config).

Inputs: id (required), name (required), type, prompt, +6 more. Returns: data

update_folderUpdate FolderA
DestructiveIdempotent
Inspect

Update a folder. name must always be supplied (the server replaces the folder config).

Inputs: name (required), folderId (required), description. Returns: data

update_folder_viewUpdate Folder ViewA
DestructiveIdempotent
Inspect

Update an existing saved view. Replaces the whole view, so name, isDefault and columns must all be supplied.

Inputs: name (required), viewId (required), columns (required), folderId (required), +1 more. Returns: data

update_media_metadataUpdate Media MetadataB
DestructiveIdempotent
Inspect

Update metadata fields (name, description, tags, status) for an existing media file.

Inputs: name (required), mediaId (required), tags, remark, +4 more. Returns: data

update_multiple_fieldsBulk Update Custom Field ValuesA
DestructiveIdempotent
Inspect

Set custom field values across media in a single batch operation. Scope the update with folderId (all media in a folder) and/or mediaIds.

Inputs: fields (required), folderId, mediaIds. Returns: data

update_recorder_questionsUpdate Recorder QuestionsB
DestructiveIdempotent
Inspect

Update the survey questions and respondent-info settings for a recorder.

Inputs: questions (required), recorderId (required), name, email, +1 more. Returns: data

update_recorder_settingsUpdate Recorder SettingsB
Idempotent
Inspect

Update configuration settings for a recorder (branding, capture options, etc.). name must always be supplied.

Inputs: name (required), recorderId (required), meta, options, +7 more. Returns: data

update_text_noteUpdate Text NoteA
DestructiveIdempotent
Inspect

Update an existing text note's name, content, or metadata. Updating text content will trigger re-analysis.

Inputs: mediaId (required), name, tags, text, +2 more. Returns: data

update_transcript_speakersRename Transcript SpeakersB
DestructiveIdempotent
Inspect

Update or rename speaker labels in a media transcript.

Inputs: mediaId (required), speakers (required). Returns: data

update_user_groupUpdate User GroupA
DestructiveIdempotent
Inspect

Update a user group's name and member list. NOTE: the users array is a FULL REPLACEMENT, not a delta — any member id you omit is removed from the group. Fetch the current members with list_user_groups first and send the complete list.

Inputs: _id (required), users (required), description (required). Returns: data

update_webhookUpdate WebhookA
Idempotent
Inspect

Update an existing webhook. This replaces the webhook config, so callbackUrl must always be supplied.

Inputs: webhookId (required), callbackUrl (required), events, description. Returns: data

upload_and_analyzeUpload and Analyze MediaAInspect

Upload and transcribe media from a URL — a direct/public file URL, OR a shareable social/video link (YouTube, Instagram, TikTok, X, Facebook, Reddit, SoundCloud, and similar), which Speak resolves to the underlying media automatically. Returns media_id immediately; after this returns, poll get_media_status until state is 'processed' (typically 1-3 min for under 60min audio), then call get_media_insights for AI summaries. This async pattern is required for remote MCP transports — long blocking calls die at proxy idle timeouts. (Vimeo links are not yet supported.)

Inputs: url (required), name, tags, folderId, +2 more. Returns: data

upload_local_fileUpload Local FileAInspect

Upload a local file to Speak AI for transcription and analysis. Reads the file from disk, gets a pre-signed S3 URL, uploads the file, then creates the media entry. Works with any audio or video file on the local filesystem. After upload, use get_media_status to poll for completion, then get_transcript and get_media_insights.

Inputs: filePath (required), name, tags, folderId, +2 more. Returns: data

upload_mediaUpload Media from URLAInspect

Upload media from a URL — a direct/public file URL, a pre-signed S3 URL, or a shareable social/video link (YouTube, Instagram, TikTok, X, Facebook, Reddit, SoundCloud, and similar) which Speak resolves to the underlying media automatically. Processing is asynchronous — after uploading, use get_media_status to poll until state is 'processed' (typically 1-3 minutes for audio under 60 min), then use get_transcript and get_media_insights to retrieve results. For a single call that handles everything, use upload_and_analyze instead. For local files, use upload_local_file. (Vimeo links are not yet supported.)

Inputs: url (required), name (required), mediaType (required), tags, +5 more. Returns: data

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 107 tools

    Disambiguation4/5

    Most tools have distinct purposes with detailed descriptions, but the sheer number (107) creates some ambiguity among closely related operations like upload_media, upload_local_file, and upload_and_analyze, or multiple transcript retrieval tools. An agent can distinguish them with careful reading but may struggle with so many similar verbs.

    Naming Consistency5/5

    Every tool follows the verb_noun snake_case pattern consistently. Verbs like create, get, list, update, delete, bulk_*, toggle_*, etc., are used uniformly. The naming is predictable and well-structured, helping agents infer purpose from name alone.

    Tool Count1/5

    107 tools is far beyond the expected range for a single server. While each tool serves a specific purpose, many could be combined (e.g., multiple list_* variants, distinct upload methods). This extreme count likely overwhelms agents and increases selection difficulty.

    Completeness5/5

    The tool set covers full CRUD for every entity (media, folders, dashboards, automations, recorders, webhooks, user groups, fields, clips, embeddings) plus search, export, batch operations, live meeting transcripts, analytics, and feedback. No obvious gaps exist for the stated purpose of a media analysis platform.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Integrates local Granola.ai meeting intelligence with Claude Desktop to enable searching and analyzing meeting transcripts, notes, and summaries. Users can perform natural language queries to retrieve meeting details, analyze participant patterns, and access full speaker-identified conversations.
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Bring your Plaud Note recordings into Claude Desktop. Search meetings, pull transcripts, and ask Claude about your notes — directly from chat.
      1
      MIT