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),srtorvtt(subtitles).include_words: add per-word start and end times totextorjsonoutput.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
envblock 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_urlneeds a direct link to the audio file, not a page that plays it. - Anything else: support@saidwire.com (include the
request_idfrom 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.