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
Get your key from app.speakai.co/developers
Run:
speakai-mcp initPaste 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 fileupload <file> --wait— upload and wait for completion before returninglist-media— list your recent filesget-transcript <id>— retrieve a transcriptget-insights <id>— retrieve AI insightsstatus <id>— check processing statusexport <id>— export a transcript (PDF, DOCX, SRT, etc.)update <id>— update file metadatadelete <id>— delete a filefavorites— list favorited filescaptions <id>— download captionsreanalyze <id>— re-run AI analysis
AI and search
ask <id> "your question"— run an AI prompt on a filechat-history <id>— view AI Chat history for a filesearch "query"— search your library by keyword
Organization
list-folders— list all folderscreate-folder "name"— create a folderschedule-meeting <url>— schedule a meeting botclips <id>— list clips for a filestats— view your usage stats (transcription hours, AI characters used)languages— list all 70+ supported transcription languagesconfig— 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].
