MacWhisper transcription for Claude Desktop. Fully local, no cloud, audio stays on your Mac.
Connect Runs on your machine
claude mcp add macwhisper-mcp-server -e MACWHISPER_ALLOWED_PATHS=<MACWHISPER_ALLOWED_PATHS> -e MACWHISPER_CLI=<MACWHISPER_CLI> -e MACWHISPER_LOG_PATH=<MACWHISPER_LOG_PATH> -- uvx macwhisper-mcp-server==1.2.1
{
"mcpServers": {
"macwhisper-mcp-server": {
"command": "uvx",
"args": [
"macwhisper-mcp-server==1.2.1"
],
"env": {
"MACWHISPER_ALLOWED_PATHS": "<MACWHISPER_ALLOWED_PATHS>",
"MACWHISPER_CLI": "<MACWHISPER_CLI>",
"MACWHISPER_LOG_PATH": "<MACWHISPER_LOG_PATH>"
}
}
}
}
{
"mcpServers": {
"macwhisper-mcp-server": {
"command": "uvx",
"args": [
"macwhisper-mcp-server==1.2.1"
],
"env": {
"MACWHISPER_ALLOWED_PATHS": "<MACWHISPER_ALLOWED_PATHS>",
"MACWHISPER_CLI": "<MACWHISPER_CLI>",
"MACWHISPER_LOG_PATH": "<MACWHISPER_LOG_PATH>"
}
}
}
}
{
"servers": {
"macwhisper-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"macwhisper-mcp-server==1.2.1"
],
"env": {
"MACWHISPER_ALLOWED_PATHS": "<MACWHISPER_ALLOWED_PATHS>",
"MACWHISPER_CLI": "<MACWHISPER_CLI>",
"MACWHISPER_LOG_PATH": "<MACWHISPER_LOG_PATH>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
MACWHISPER_ALLOWED_PATHSRequired | Colon-separated list of directories the server may read audio files from (e.g. ~/Desktop:~/Downloads) |
MACWHISPER_CLIOptional | Path to the mw binary. Auto-detected from /Applications/MacWhisper.app if omitted. |
MACWHISPER_LOG_PATHOptional | Log file path. Defaults to ~/Library/Logs/macwhisper-mcp.log |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 15 Oct 2026 |
| Last updated | 15 Oct 2026 |
| Registry name | io.github.docdyhr/macwhisper-mcp-server |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
