Skip to main content

Using the Speak AI CLI

Install the Speak AI CLI, configure your API key, and run commands from the terminal. Covers upload, transcription, AI Chat, search, and organization commands.

Written by Speak Ai

Using the Speak AI CLI

The Speak AI CLI lets you upload files, retrieve transcripts, run AI prompts, and manage your library from the command line — useful for batch workflows, scripts, and CI/CD pipelines.

Installation

Requires Node.js 18+.

npm install -g @speakai/mcp-server

Set up your API key

  1. Get your key from app.speakai.co/developers

  2. Run: speakai-mcp init

  3. Paste your API key when prompted

Or set it directly: speakai-mcp config set-key YOUR_API_KEY

Media commands

  • upload <file> — upload and transcribe a file

  • upload <file> --wait — upload and wait for completion before returning

  • list-media — list your recent files

  • get-transcript <id> — retrieve a transcript

  • get-insights <id> — retrieve AI insights

  • status <id> — check processing status

  • export <id> — export a transcript (PDF, DOCX, SRT, etc.)

  • update <id> — update file metadata

  • delete <id> — delete a file

  • favorites — list favorited files

  • captions <id> — download captions

  • reanalyze <id> — re-run AI analysis

AI and search

  • ask <id> "your question" — run an AI prompt on a file

  • chat-history <id> — view AI Chat history for a file

  • search "query" — search your library by keyword

Organization

  • list-folders — list all folders

  • create-folder "name" — create a folder

  • schedule-meeting <url> — schedule a meeting bot

  • clips <id> — list clips for a file

  • stats — view your usage stats (transcription hours, AI characters used)

  • languages — list all 70+ supported transcription languages

  • config — manage CLI configuration and API key

Example: upload and get AI summary

# Upload a recording and wait for transcription
speakai-mcp upload meeting.mp4 --wait# Ask an AI question (use the media ID from the upload output)
speakai-mcp ask <media-id> "What were the key decisions made in this meeting?"# Export as PDF
speakai-mcp export <media-id> --format pdf

For the full command reference and 28 available commands, see the Speak AI MCP GitHub README.


Still stuck? Chat with us below or email [email protected].

Did this answer your question?