Speak AI MCP Server
OfficialA Speak AI connector that lets an AI assistant transcribe, search, analyze, and manage your audio/video recordings, text notes, meetings, and workspace data.
Upload & transcribe media: upload from a URL, social/video link, pre-signed S3 URL, or local file (stdio only); poll processing status; fetch transcripts, captions, and AI insights (topics, sentiment, summaries, action items).
Search & analyze: deep-search transcripts/insights across the library with filters, list/filter media with inline transcripts, get workspace statistics, and ask AI questions across files, folders, or the whole workspace (with conversation continuation, personas, and per-file comparison).
Manage media: update metadata, move files in bulk, rename speakers (single or up to 500 files), favorite, re-analyze, set thumbnails, edit transcript text, and delete.
Export: transcripts/insights as PDF, DOCX, SRT, VTT, TXT, CSV (with redaction, timestamps, speaker names), plus batch/merged exports; export chat answers.
Folders & views: create, clone, update, delete folders and saved views; list folder contents and views.
Clips: create highlight clips from time ranges across files (max 30 min), list/update/delete clips.
Meetings: schedule the AI assistant to join meetings (Zoom, Meet, Teams, Webex), list/cancel events, remove the bot, and pull incremental live transcripts.
Recorders/surveys: create, clone, list, update settings/questions, get submissions, generate share URLs, check status, delete.
AI chat history: list conversations and messages, retry failed answers, rename/delete chats, favorite prompts, submit feedback, view usage stats.
Custom fields & organization: create/update/list fields, bulk-set field values, manage labels and comments on transcripts.
Text notes: create text notes for AI analysis, get insights, re-analyze, update.
Embeds: create/update embeddable player widgets, check existence, get iframe URLs, view embed session analytics.
Users, groups & dashboards: list workspace members and groups, create/update/delete groups, list/get/create/update/duplicate/share analytics dashboards.
Automations & webhooks: browse automation triggers/actions/apps, build/create/update/run/toggle/delete automations, inspect runs, and manage outbound webhooks.
Billing & feedback: check plan/credits/trial status and send feedback to the Speak AI team.
Allows querying Speak AI workspace for transcripts, summaries, action items, sentiment, and themes from within ChatGPT.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Speak AI MCP Server summarize last week's customer interviews with key action items"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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/mcpand 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)
Click Add custom connector
Name it Speak AI and paste
https://api.speakai.co/v1/mcp, then click AddA permission popup asks you to log into Speak AI and click Allow
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.

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

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
Open Claude Desktop → Settings → Connectors → Add custom connector
Paste
https://api.speakai.co/v1/mcpClick Add. A permission popup opens. Sign in to Speak AI and click Allow on the screen that appears.
Done.
Get a key at app.speakai.co/developers/apikeys, then in step 2 also expand Custom headers and add:
Header name:
AuthorizationHeader value:
Bearer <your-speak-api-key>
Then click Add.
ChatGPT
Open Speak AI in ChatGPT while signed in to ChatGPT
Click Install plugin
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.
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.

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

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/mcpand 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 speakaiclaude 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:
Add the official marketplace (one-time):
/plugin marketplace add claude-plugins-officialInstall the plugin:
/plugin install speakai@claude-plugins-officialActivate it:
/reload-pluginsType
/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/mcpCodex 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 speakaiCheck 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_KEYGenerate a key at app.speakai.co/developers/apikeys.
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
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.
Visit the Speak AI skill page on ClawHub
Follow the install instructions for your agent, for example
clawhub install speakaifrom the ClawHub CLISet your
SPEAK_API_KEYenvironment 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" |
|
"Summarize this week's meetings into decisions, owners, and risks" |
|
"Pull action items from yesterday's call" |
|
"Schedule the AI to join my 2pm Zoom" |
|
"Pull the live transcript from my current MS Teams meeting since last fetch" |
|
"Find a 30-second webinar highlight and export captions" |
|
"Export the transcript as a PDF and captions as SRT" |
|
"Compare Q1 sales calls against Q2 sales calls and summarize changed objections" |
|
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:
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.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 initManual 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-serverAdd 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-serverEnvironment variables
Variable | Required | Default | Description |
| Yes | -- | Your Speak AI API key |
| No | Auto-managed | JWT access token (auto-fetched and refreshed) |
| No |
| API base URL |
| No | -- | Set to |
MCP Tools
Tool | Description |
| Edit the official transcript text of a media file by finding and replacing text |
| Get a pre-signed S3 URL for direct file upload |
| Import an audio or video file from a direct public URL, a |
| Upload a local file directly from disk (stdio and CLI only, never on the remote server) |
| Upload media from a URL (direct file, or any social/video page link |
| List and search media files with filters, pagination, and optional inline data (transcripts, speakers, keywords) via |
| Get AI insights: topics, sentiment, summaries, action items |
| Get full transcript with speaker labels and timestamps |
| Get subtitle-formatted captions for a media file |
| Rename speaker labels in a transcript |
| Rename speaker labels across multiple media files in one call (max 500) |
| Check processing status (pending → processed) |
| Update name, description, tags, or folder |
| 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) |
| Permanently delete a media file |
| Mark or unmark media as a favorite |
| Re-run AI analysis with latest models |
| Move multiple media files to a folder in one call |
| 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 questions about media, folders, or your whole workspace |
| Retry a failed or incomplete AI Chat response |
| List recent AI Chat conversations |
| Get full message history for conversations |
| Delete a whole chat conversation and its messages |
| List recent AI chat messages with their answers and sources |
| Get all favorited prompts and answers |
| Mark or unmark a chat message as favorite |
| Rename a chat conversation |
| Rate a chat response (thumbs up/down) |
| Get AI Chat usage statistics |
| Export a conversation or answer |
| 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 |
| Deep search across transcripts, insights, and metadata with filters |
| Get workspace-level stats: counts, storage, processing breakdown |
| List all supported transcription languages |
Tool | Description |
| List all folders with pagination and sorting |
| Get folder details and contents |
| Create a new folder |
| Duplicate a folder and its contents |
| Rename or update a folder, or change which users and groups can access it |
| Delete a folder (media is preserved) |
| List all saved views across folders |
| List views for a specific folder |
| Create a saved view with custom filters |
| Update a saved view |
| Duplicate a view |
Tool | Description |
| Create a new recorder or survey |
| List all recorders |
| Get recorder details and questions |
| Duplicate a recorder |
| List all submissions |
| Get a shareable public URL |
| Update branding and permissions |
| Update survey questions |
| Check if recorder is active |
| Delete a recorder |
Tool | Description |
| Create a highlight clip from time ranges across media files |
| List clips or get a specific clip with download URL |
| Update clip title, description, or tags |
| Permanently delete a clip |
Tool | Description |
| Export as PDF, DOCX, SRT, VTT, TXT, CSV, or a labels CSV ( |
| Batch export with optional merge into one file, including labels CSVs |
Tool | Description |
| List scheduled and completed events |
| Schedule AI assistant to join a meeting |
| Remove assistant from active meeting |
| Cancel a scheduled meeting assistant |
| 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 automation rules with paging and filters |
| Get automation details (trigger + step graph) |
| Create an automation rule (V2 trigger + steps graph) |
| Update an automation (replaces trigger + steps) |
| Enable or disable an automation |
| List names and ids of active automations that have an AI chat step |
| Get an automation's run history |
| Activate/deactivate multiple automations |
| Set folder scope for multiple automations |
| Manually run automations against media now |
| Permanently delete an automation |
| List catalog apps: Speak built-ins plus third-party apps marked connected or not connected (read-only) |
| List catalog trigger types (optionally by app) |
| List catalog action/step types (optionally by app) |
| Create or update an automation from a friendly spec, without the wire format |
| Get one run in full: every step, plus which way each branch went |
| Aggregate run outcome counts over a period |
| Run an automation once against one media item (real side effects) |
| Check a step graph for problems without saving it |
| Show a saved automation's steps as an indented branch tree |
Tool | Description |
| Create a webhook for event notifications |
| List all webhooks |
| Update a webhook |
| Delete a webhook |
| Provision a standalone inbound webhook and get its public receive URL |
| Get an inbound webhook's receive URL, sample payload, and trigger tokens |
| Get the delivery log for an inbound webhook, with acknowledgement status |
Tool | Description |
| Create a text note for AI analysis (uses the plan allowance, then credits) |
| Get AI insights for a text note |
| Re-run AI analysis on a text note |
| Update a note's name or content (only a note not yet analyzed is analyzed) |
Tool | Description |
| List all custom fields |
| Create a custom field |
| Update a custom field |
| Batch update multiple fields |
Tool | Description |
| List workspace labels and groups as a tree |
| Create a label or a label group |
| Rename, recolor, describe, move or reorder a label |
| Archive a label (a group takes its labels along) |
| Restore an archived label or group |
| Move every use of one label onto another |
| Add ready-made Speak label groups |
| List the labels applied to a transcript |
| Label transcript words, found by quote or word range |
| Change a span's labels, confirm it, or move it |
| Remove a labelled span |
| List a file's comment threads |
| Comment on the file or on words, or reply to a thread |
| Edit the text of your own comment |
| Resolve or reopen a thread |
| Delete a comment |
Tool | Description |
| Create an embeddable player widget |
| Update embed settings |
| Check if embed exists for media |
| Get iframe URL for your website |
| Owner analytics: list visits to an embed with viewer, device, country and traffic filters |
| Owner analytics: an embed's visit KPIs, daily trend, sources and per-media table |
| Owner analytics: one embed visit in full, with paged events |
Tool | Description |
| List workspace members with ids, emails, and permissions |
| List user groups with hydrated members |
| Create a user group and assign members |
| Update a group's name and members (full replace) |
| Delete a user group |
Tool | Description |
| List widget types, their config keys, and an example payload |
| List analytics dashboards you can access |
| Get a dashboard's full config (widgets, filters, scope) |
| Create a dashboard with auto-laid-out widgets |
| Update a dashboard (partial; widgets are replaced) |
| Soft-delete a dashboard and its share link |
| Clone a dashboard with fresh widget ids |
| Enable public sharing and return the share token |
| Speakers breakdown for a folder/date/filter scope |
Tool | Description |
| List the company's voice agents (newest first) with their config |
| Get a single voice agent by agentId |
| Create a voice agent (name, personality, instructions, and voice are required) |
| Update a voice agent; send only the fields you want to change |
| Delete a voice agent; its share link, questions, and test suite stop working (no restore tool) |
| Create a new agent from a plain-English description; an LLM generates its name, instructions, and settings |
| Run the same prompt-to-config generation against an existing agent |
| Discovery helper: the build order, which tool covers each piece, common mistakes |
| List the video avatars available to attach to a voice agent |
| List the text-to-speech voices available to a voice agent |
| List conversations handled by voice agents (filter by agentId) |
| Get a single conversation by conversationId |
| Owner analytics for one voice agent over a date range (KPIs, audience, outcomes, quality) |
| List the questions configured on a voice agent, in ask order |
| Get a single question by fieldId |
| Attach a question template to a voice agent |
| Partially update a voice agent question |
| Remove a question from a voice agent |
| Set the order a voice agent asks its questions in |
| List the shared and company-owned question template library |
| Create a company-scoped custom question template |
| Get a voice agent's test suite (its scenarios and run settings) |
| Create or update a voice agent's test suite (upserts; replaces scenarios) |
| Auto-generate a default test suite from the agent's name, personality and instructions |
| 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 a voice agent's currently active run (queued, running, or paused) |
| Pause a running or queued test run; takes effect after the current scenario |
| Resume a paused test run from the next scenario |
| Cancel a test run at its next AI call; cost already used is charged; terminal |
| List a voice agent's test runs, most recent first |
| Get a test run's full detail, including scenario results and recommendations |
| Apply a test run recommendation's quick action to the agent |
| Get a voice agent's best-scoring completed run, for regression comparison |
| 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 a voice agent's pending knowledge-base gaps from real calls |
| Trigger knowledge-base gap analysis over an agent's recent calls |
| Write a gap's answer into the agent's knowledge base |
| Dismiss a gap without writing anything |
| List a voice agent's pending FAQ suggestions clustered from real calls |
| Trigger FAQ clustering over an agent's recent calls |
| Write an FAQ suggestion into the agent's knowledge base |
| Edit a pending FAQ suggestion's question and/or answer |
| Dismiss an FAQ suggestion without writing anything |
| List the documents/links a voice agent searches during calls |
| Add one document/link to a voice agent's knowledge base |
| Add up to 100 documents/links in one call |
| Partially update a voice agent resource |
| Soft-delete a voice agent resource |
| Advisory-only patch suggestions for an agent's own instructions |
| Insert a suggested patch into an agent's instructions |
Tool | Description |
| Plan, remaining credits, renewal or trial end, and whether a payment is pending |
Tool | Description |
| 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 |
| List of all media files in your workspace |
Folders |
| List of all folders |
Supported Languages |
| Transcription language list |
Transcript |
| Full transcript for a specific media file |
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-keyOr run without installing:
npx @speakai/mcp-server config set-keyConfiguration
Command | Description |
| Set your API key (interactive if no key given) |
| Show current configuration |
| Validate API key and test connectivity |
| Set custom API base URL |
| Interactive setup: configure key and auto-detect MCP clients |
Media management
Command | Description |
| List media files with filtering, date ranges, and pagination |
| Upload media from URL or local file ( |
| Get transcript ( |
| Get AI insights (topics, sentiment, keywords) |
| Check media processing status |
| Export transcript ( |
| Update media metadata (name, description, tags, folder) |
| Delete a media file |
| Toggle favorite status |
| Get captions for a media file |
| Re-run AI analysis with latest models |
AI & Search
Command | Description |
| Ask AI about media, folders, or your whole workspace |
| List past AI Chat conversations |
| Full-text search across transcripts and insights |
Folders & Clips
Command | Description |
| List all folders |
| Move media files to a folder |
| Create a new folder |
| List clips (filter by media or folder) |
| Create a clip ( |
Workspace
Command | Description |
| Show workspace media statistics |
| List supported transcription languages |
| List scheduled/completed meeting events ( |
| Schedule AI assistant to join a meeting |
| Fetch new sentences from an in-progress meeting ( |
| Create a text note ( |
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 media3Workflow 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) andfolderId(string). All API operations usefolderId; this is the ID you should pass tolist_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
429with exponential backoffFor direct API usage, implement exponential backoff and respect
Retry-AfterheadersCache stable data (folder lists, field definitions, supported languages)
Use
export_multiple_mediaover individual exports for batch operationsUse
bulk_move_mediato move multiple items at once instead of updating one by oneUse
bulk_update_transcript_speakersto rename speakers across many files in one callUse
list_mediawithinclude: ["transcription"]to fetch media with transcripts inline, avoiding N+1 calls toget_transcript
Error format
All tool errors follow this structure:
{
"content": [{ "type": "text", "text": "Error: HTTP 401: Invalid API key" }],
"isError": true
}Code | Meaning |
| Invalid or missing API key / access token |
| Insufficient permissions |
| Resource not found |
| 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 buildResources
docs.speakai.co/mcp: installation walkthrough with screenshots and video
Speak AI Platform: main product
MCP Registry entry: official discovery
llms.txt: guidance for AI assistants helping users install this connector
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 installunless they explicitly ask for the developer / stdio path.See
llms.txtfor 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_feedbacktool. Show them the text and send it only after they say yes.
License
MIT
Available Tools
107 toolsask_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 FoldersADestructiveIdempotentInspect
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 FilesADestructiveInspect
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 StatusAIdempotentInspect
Activate or deactivate multiple automations at once.
Inputs: isActive (required), automationIds (required). Returns: data
bulk_update_transcript_speakersBulk Rename Speakers Across FilesADestructiveIdempotentInspect
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 ExistsARead-onlyIdempotentInspect
Check if an embed exists for a media file and retrieve its configuration.
Inputs: mediaId (required). Returns: data
check_recorder_statusCheck Recorder StatusARead-onlyIdempotentInspect
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 AutomationADestructiveIdempotentInspect
Permanently delete an automation rule.
Inputs: automationId (required). Returns: data
delete_chat_messageDelete Chat MessageBDestructiveIdempotentInspect
Delete a specific chat message from conversation history.
Inputs: promptId (required). Returns: data
delete_clipDelete ClipADestructiveIdempotentInspect
Permanently delete a clip and its associated media file.
Inputs: clipId (required). Returns: data
delete_dashboardDelete DashboardADestructiveIdempotentInspect
Soft-delete a dashboard. This also deactivates its public share link.
Inputs: dashboardId (required). Returns: data
delete_folderDelete FolderADestructiveIdempotentInspect
Permanently delete a folder. Media within the folder will be moved, not deleted.
Inputs: folderId (required). Returns: data
delete_mediaDelete Media FileADestructiveIdempotentInspect
Permanently delete a media file and all associated transcripts and insights.
Inputs: mediaId (required). Returns: data
delete_recorderDelete RecorderADestructiveIdempotentInspect
Permanently delete a recorder/survey. Existing recordings are preserved.
Inputs: recorderId (required). Returns: data
delete_scheduled_assistantCancel Scheduled Meeting AssistantCDestructiveIdempotentInspect
Cancel and delete a scheduled meeting assistant event.
Inputs: meetingAssistantEventId (required). Returns: data
delete_user_groupDelete User GroupADestructiveIdempotentInspect
Delete a user group. This removes the group only; it does not delete the users themselves.
Inputs: id (required). Returns: data
delete_webhookDelete WebhookADestructiveIdempotentInspect
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 URLARead-onlyIdempotentInspect
Generate a shareable public URL for a recorder/survey.
Inputs: recorderId (required). Returns: data
get_all_folder_viewsGet All Folder ViewsARead-onlyIdempotentInspect
Retrieve all saved views across all folders.
Inputs: no named parameters. Returns: data
get_automationGet Automation DetailsARead-onlyIdempotentInspect
Get detailed information about a specific automation rule, including its trigger and step graph.
Inputs: automationId (required). Returns: data
get_automation_runsGet Automation RunsARead-onlyIdempotentInspect
Get the run history (executions) for an automation, with paging and optional status filter.
Inputs: automationId (required), page, status, pageSize. Returns: data
get_captionsGet CaptionsARead-onlyIdempotentInspect
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 HistoryARead-onlyIdempotentInspect
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 MessagesARead-onlyIdempotentInspect
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 StatisticsARead-onlyIdempotentInspect
Get usage statistics for Magic Prompt / chat. Returns metrics on prompt usage, optionally filtered by date range.
Inputs: endDate, startDate. Returns: data
get_clipsList ClipsARead-onlyIdempotentInspect
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 DashboardARead-onlyIdempotentInspect
Get a single dashboard's full config (widgets, filters, date range, folder scope).
Inputs: dashboardId (required). Returns: data
get_dashboard_speakers_insightGet Dashboard Speakers InsightARead-onlyIdempotentInspect
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 URLARead-onlyIdempotentInspect
Get the iframe URL for embedding a media player/transcript on a webpage.
Inputs: mediaId (required). Returns: data
get_favorite_promptsGet Favorite PromptsARead-onlyIdempotentInspect
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 InfoBRead-onlyIdempotentInspect
Get detailed information about a specific folder including its contents.
Inputs: folderId (required). Returns: data
get_folder_viewsGet Folder ViewsARead-onlyIdempotentInspect
Retrieve all saved views for a specific folder.
Inputs: folderId (required). Returns: data
get_live_meeting_transcriptGet Live Meeting TranscriptARead-onlyInspect
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 InsightsARead-onlyIdempotentInspect
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 StatisticsARead-onlyIdempotentInspect
Get workspace-level media statistics — total counts, processing status breakdown, storage usage, etc.
Inputs: no named parameters. Returns: data
get_media_statusGet Media StatusARead-onlyIdempotentInspect
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 InfoARead-onlyIdempotentInspect
Get detailed information about a specific recorder including its settings and questions.
Inputs: recorderId (required). Returns: data
get_recorder_recordingsGet Recorder SubmissionsARead-onlyIdempotentInspect
List all submissions/recordings collected by a specific recorder.
Inputs: recorderId (required). Returns: data
get_signed_upload_urlGet Signed Upload URLARead-onlyInspect
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 InsightsARead-onlyIdempotentInspect
Retrieve AI-generated insights for a text note, including topics, sentiment, summaries, and action items.
Inputs: mediaId (required). Returns: data
get_transcriptGet TranscriptARead-onlyIdempotentInspect
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 ActionsARead-onlyIdempotentInspect
List the action/step types available in the automation catalog. Optionally filter by app.
Inputs: app. Returns: data
list_automation_appsList Automation AppsARead-onlyIdempotentInspect
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 NamesARead-onlyIdempotentInspect
List automations as lightweight { name, id } pairs — useful for pickers without fetching full configs.
Inputs: no named parameters. Returns: data
list_automationsList AutomationsARead-onlyIdempotentInspect
List automation rules in the workspace, with paging and filters.
Inputs: page, query, sortBy, runType, +3 more. Returns: data
list_automation_triggersList Automation TriggersARead-onlyIdempotentInspect
List the trigger types available in the automation catalog. Optionally filter by app.
Inputs: app. Returns: data
list_dashboardsList DashboardsARead-onlyIdempotentInspect
List all analytics dashboards the caller can access, including share state.
Inputs: no named parameters. Returns: data
list_dashboard_widgetsList Dashboard WidgetsARead-onlyIdempotentInspect
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 FieldsARead-onlyIdempotentInspect
List all custom fields defined in the workspace.
Inputs: no named parameters. Returns: data
list_foldersList FoldersARead-onlyIdempotentInspect
List all folders in the workspace with pagination and sorting.
Inputs: page, sortBy, pageSize. Returns: data
list_mediaList Media FilesARead-onlyIdempotentInspect
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 EventsARead-onlyIdempotentInspect
List scheduled or completed meeting assistant events with filtering and pagination.
Inputs: page, pageSize, platformType, meetingStatus. Returns: data
list_promptsList Prompt TemplatesARead-onlyIdempotentInspect
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 RecordersARead-onlyIdempotentInspect
List all recorders/surveys in the workspace.
Inputs: page, sortBy, pageSize. Returns: data
list_supported_languagesList Supported LanguagesARead-onlyIdempotentInspect
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 GroupsARead-onlyIdempotentInspect
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 UsersARead-onlyIdempotentInspect
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 WebhooksARead-onlyIdempotentInspect
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 MeetingBIdempotentInspect
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 LibraryARead-onlyIdempotentInspect
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
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 FavoriteAIdempotentInspect
Mark or unmark media files as favorites for quick access.
Inputs: mediaIds (required), isFavorite (required). Returns: data
toggle_prompt_favoriteToggle Prompt FavoriteAIdempotentInspect
Mark or unmark a chat message as a favorite for easy retrieval later.
Inputs: promptId (required), messageId (required), isFavorite (required). Returns: data
update_automationUpdate AutomationADestructiveIdempotentInspect
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 ChatAIdempotentInspect
Update the title of a chat conversation for easier identification in history.
Inputs: title (required), promptId (required). Returns: data
update_clipUpdate ClipBIdempotentInspect
Update a clip's title, description, or tags.
Inputs: clipId (required), tags, title, description. Returns: data
update_dashboardUpdate DashboardADestructiveIdempotentInspect
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 WidgetAIdempotentInspect
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 FieldADestructiveIdempotentInspect
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 FolderADestructiveIdempotentInspect
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 ViewADestructiveIdempotentInspect
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 MetadataBDestructiveIdempotentInspect
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 ValuesADestructiveIdempotentInspect
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 QuestionsBDestructiveIdempotentInspect
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 SettingsBIdempotentInspect
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 NoteADestructiveIdempotentInspect
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 SpeakersBDestructiveIdempotentInspect
Update or rename speaker labels in a media transcript.
Inputs: mediaId (required), speakers (required). Returns: data
update_user_groupUpdate User GroupADestructiveIdempotentInspect
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 WebhookAIdempotentInspect
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
Scored across 107 tools
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.
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.
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.
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
Related MCP Connectors
Connect Claude to Fathom meeting recordings, transcripts, and summaries
Ask Claude about your meetings: summaries, action items and transcripts from Roomtone
Connect your team's living knowledge base — docs, data, issues, CRM — to Claude and ChatGPT.
Your Microsoft Teams call transcripts, with real speaker names: search, read, ask.
Related MCP Servers
- AlicenseAqualityDmaintenanceIntegrates 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.5MIT
- AlicenseNot gradedqualityDmaintenanceBring your Plaud Note recordings into Claude Desktop. Search meetings, pull transcripts, and ask Claude about your notes — directly from chat.1MIT
- AlicenseNot gradedqualityDmaintenanceConnects your Plaud voice recorder to Claude, giving access to recordings, transcripts, and AI summaries so you can query your notes via natural language.17MIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude to access your Fathom meetings, transcripts, and AI summaries.16MIT