Skip to main content

Saidwire MCP server

Speech-to-text for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code and any other Model Context Protocol client. Ask your assistant to transcribe a recording on your computer or at a public URL, and get plain text, subtitles (SRT/VTT) or word-level timestamps back.

"Transcribe ~/Downloads/standup.m4a and list the action items." "Make subtitles for https://example.com/talk.mp3 and save them to ~/talk.srt."

  • English speech-to-text, punctuated and capitalised.
  • WAV, MP3, FLAC, Ogg/Opus, WebM, M4A/MP4 and AAC, up to 100 MB / 60 minutes per file.
  • $0.30 per audio hour. New keys include 120 free hours, no card needed.
  • Built and maintained by Saidwire, the company that runs the service.

1. Get a free API key

Sign up at saidwire.com/dev and copy your key (it starts with sk_live_).

2. Add the server to your client

You need uv (it provides uvx; no Node or npm needed):

curl -LsSf https://astral.sh/uv/install.sh | sh      # macOS / Linux
# Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Claude Desktop

Settings → Developer → Edit Config (claude_desktop_config.json), then restart Claude:

{
  "mcpServers": {
    "saidwire": {
      "command": "uvx",
      "args": ["saidwire-mcp"],
      "env": { "SAIDWIRE_API_KEY": "sk_live_your_key_here" }
    }
  }
}

If Claude says it cannot find uvx, replace "uvx" with the full path from which uvx (it usually ends in /.local/bin/uvx). Desktop apps do not always see your shell's PATH.

Or double-click saidwire-mcp.mcpb (from the GitHub release) to install it as a Claude Desktop extension; Claude asks for the key.

Claude Code

claude mcp add saidwire --scope user -e SAIDWIRE_API_KEY=sk_live_your_key_here -- uvx saidwire-mcp

Cursor

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "saidwire": {
      "command": "uvx",
      "args": ["saidwire-mcp"],
      "env": { "SAIDWIRE_API_KEY": "sk_live_your_key_here" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json: the same mcpServers block as Cursor.

VS Code (Copilot agent mode)

.vscode/mcp.json:

{
  "inputs": [
    { "type": "promptString", "id": "saidwire-key", "description": "Saidwire API key", "password": true }
  ],
  "servers": {
    "saidwire": {
      "command": "uvx",
      "args": ["saidwire-mcp"],
      "env": { "SAIDWIRE_API_KEY": "${input:saidwire-key}" }
    }
  }
}

Any other client

Command uvx saidwire-mcp (stdio transport), with SAIDWIRE_API_KEY in its environment. pip install saidwire-mcp also works and installs a saidwire-mcp command.

Tools

tool what it does
transcribe_file(path, format="text", include_words=false, output_path=null) Transcribes an audio file on this computer. Use an absolute path.
transcribe_url(url, format="text", include_words=false, output_path=null) Downloads a public audio file (direct http/https link) and transcribes it.
  • format: text (plain transcript), json (transcript, utterances and per-word timestamps), srt or vtt (subtitles).
  • include_words: add per-word start and end times to text or json output.
  • output_path: also save the result to this absolute path (for example ~/talk.srt).

Settings

environment variable default
SAIDWIRE_API_KEY (required) Your key from saidwire.com/dev.
SAIDWIRE_MAX_DOWNLOAD_MB 100 Size limit for transcribe_url downloads (max 100).
SAIDWIRE_ALLOW_PRIVATE_URLS off Set to 1 to let transcribe_url fetch from local or private network addresses.
SAIDWIRE_API_URL https://api.saidwire.com API base URL.

Privacy

The server runs on your computer. It reads only the files you ask it to transcribe, sends the audio to the Saidwire API over HTTPS, and returns the text to your client. Your key stays in your local client config. See "Data handling" in the API docs for how the service treats audio.

Troubleshooting

  • "SAIDWIRE_API_KEY is not set": add the env block shown above and restart the client.
  • "API key was not accepted" (401): copy the whole key, including the part after the dot.
  • "included hours are used up" (402): add hours at saidwire.com/dev.
  • "web page, not an audio file": transcribe_url needs a direct link to the audio file, not a page that plays it.
  • Anything else: support@saidwire.com (include the request_id from the error).

The API

This server uses the pre-recorded endpoint POST https://api.saidwire.com/v1/listen. Saidwire also offers real-time streaming over WebSocket (final transcripts about 35 ms after end of speech) and an OpenAI-compatible POST /v1/audio/transcriptions. Docs: saidwire.com/docs/api.

Development

uv venv && uv pip install -e ".[test]"
.venv/bin/pytest                                   # offline unit tests + MCP stdio no-key test
SAIDWIRE_API_KEY=sk_live_... SAIDWIRE_TEST_AUDIO=/abs/path/clip.wav .venv/bin/pytest -m live -v

License

MIT

Metadata

Release files for saidwire-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for saidwire-mcp 0.1.0
File Size Uploaded Provenance Actions
saidwire_mcp-0.1.0.tar.gz 15.2 kB Without provenance Details for saidwire_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for saidwire-mcp 0.1.0
File Interpreter ABI Platform Actions
saidwire_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for saidwire_mcp-0.1.0-py3-none-any.whl

Total release size: 26.9 kB

Release files / saidwire_mcp-0.1.0.tar.gz

Download URL saidwire_mcp-0.1.0.tar.gz
Size 15.2 kB
Tags Source
SHA-256 checksum
How to use checksums
09cd3b8ecc85f2a5c1b115922ace8419f42997bd0ebffc625c4de7a533c2a869
BLAKE2b-256 checksum
How to use checksums
3cfd8f99be413f8928faf615555d900290461ce6cd807083f7eca02b6969808b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / saidwire_mcp-0.1.0-py3-none-any.whl

Download URL saidwire_mcp-0.1.0-py3-none-any.whl
Size 11.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a180f0501440bc9069a2047d1394843b561181fbd11ac76ee8f20de484a3f062
BLAKE2b-256 checksum
How to use checksums
49546706d85fe23bcf8f6d332fbc9ee2c57efb7ee6dc5a14a7348136fcc807ab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for saidwire-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page