# SpeechWeave

> SpeechWeave is an open-source MCP server for ai models and llm tooling. Transcribe local audio files and public URLs from your editor through SpeechWeave. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://speechweave.com/docs/mcp
- **Repository:** https://github.com/speechweave/speechweave-mcp
- **MCP Registry name:** io.github.speechweave/mcp
- **Categories:** AI models and LLM tooling, files and documents
- **Listing updated:** 2026-11-15

## About

Eight tools cover both ways of getting a transcript. The sync pair, transcribe_file and transcribe_url, return text in the same call. The async pair, start_job_file and start_job_url, hand back a job id straight away so a long recording can be polled later with get_job_status or stopped with cancel_job. Audio is never passed as raw bytes: local clients give an absolute path and others give a public HTTPS URL.

Options include a core or max model, standard or deferred service mode (deferred costs less and has lower priority), a forced language code, translation to English, and a vocabulary prompt for names and acronyms. Transcripts can come back as text, SRT, VTT or verbose JSON, or be written to a .txt, .md, .json, .srt or .vtt file so long output stays out of the conversation.

Billing problems such as a spend cap or an empty wallet come back as tool errors with a hint telling the assistant not to retry. It needs Node.js 18+ and a SpeechWeave API key.

## Features

- **Sync and async delivery:** Get the transcript in one call or start a job and poll for it.
- **Output formats:** Return plain text, SRT, VTT or verbose JSON with segment timings.
- **Save to file:** Write the transcript to a file so long text stays out of the chat.
- **Translate or hint:** Translate to English or pass a vocabulary prompt for proper nouns.
- **Billing hints:** Spend-cap and balance errors include a hint so the assistant does not retry.
- **Limits lookup:** get_limits reports upload size ceilings for your API key.

## Good for

- Transcribe a meeting recording from a path in your project
- Turn a public podcast URL into SRT subtitles
- Run a long file as a background job and check on it later
- Translate foreign-language audio to English text

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env SPEECHWEAVE_API_KEY='<SPEECHWEAVE_API_KEY>' -- npx -y @speechweave/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@speechweave/mcp"
      ],
      "env": {
        "SPEECHWEAVE_API_KEY": "<SPEECHWEAVE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@speechweave/mcp"
      ],
      "env": {
        "SPEECHWEAVE_API_KEY": "<SPEECHWEAVE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@speechweave/mcp"
      ],
      "env": {
        "SPEECHWEAVE_API_KEY": "<SPEECHWEAVE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@speechweave/mcp"
      ],
      "env": {
        "SPEECHWEAVE_API_KEY": "<SPEECHWEAVE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@speechweave/mcp"
      ],
      "env": {
        "SPEECHWEAVE_API_KEY": "<SPEECHWEAVE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `transcribe_file`: Transcribes a local file and returns the text
- `transcribe_url`: Transcribes a public HTTPS URL and returns the text
- `start_job_file`: Starts an async job for a local file
- `start_job_url`: Starts an async job for a URL
- `get_job_status`: Polls status or transcript for a job id
- `cancel_job`: Cancels a queued or processing job
- `get_limits`: Shows upload size ceilings for the API key
- `fetch_doc`: Fetches public docs by slug

## FAQ

### How do I install it?

Set SPEECHWEAVE_API_KEY and run npx -y @speechweave/mcp. It needs Node.js 18 or newer.

### Can I send raw audio over MCP?

No. Pass an absolute local file path or a public HTTPS URL.

### What is deferred service mode?

A lower-cost, lower-priority mode that works with either sync or async tools.

### What licence is it under?

The README badge shows the MIT licence.

### Is SpeechWeave free?

Yes. SpeechWeave is open source, so you can use and self-host it for free.

### How do I add SpeechWeave to Claude Code?

Run this command in your terminal: claude mcp add mcp --env SPEECHWEAVE_API_KEY='<SPEECHWEAVE_API_KEY>' -- npx -y @speechweave/mcp

### What are the best alternatives to SpeechWeave?

The closest alternatives to SpeechWeave are Claude Code Ultimate Guide, ASTra, CARTESIAN ECU, Invoices and SigPen.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/speechweave
