How do I install Macwhisper?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Macwhisper need an API key?

The publisher lists these environment variables: MACWHISPER_ALLOWED_PATHS, MACWHISPER_CLI, MACWHISPER_LOG_PATH.

What transport does Macwhisper use?

Macwhisper runs locally over stdio.

When was Macwhisper last checked?

Last checked 2026-11-09. MacWhisper transcription for Claude Desktop. Fully local, no cloud, audio stays on your Mac.

Macwhisper MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx macwhisper-mcp-server==1.2.1

Credentials from the publisher

MACWHISPER_ALLOWED_PATHS — Colon-separated list of directories the server may read audio files from (e.g. ~/Desktop:~/Downloads)
MACWHISPER_CLI — Path to the mw binary. Auto-detected from /Applications/MacWhisper.app if omitted.
MACWHISPER_LOG_PATH — Log file path. Defaults to ~/Library/Logs/macwhisper-mcp.log

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1MACWHISPER_ALLOWED_PATHS=<value> MACWHISPER_CLI=<value> MACWHISPER_LOG_PATH=<value> claude mcp add io.github.docdyhr-macwhisper-mcp-server -- uvx macwhisper-mcp-server==1.2.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.docdyhr-macwhisper-mcp-server": {4      "command": "uvx",5      "args": [6        "macwhisper-mcp-server==1.2.1"7      ],8      "env": {9        "MACWHISPER_ALLOWED_PATHS": "<value>",10        "MACWHISPER_CLI": "<value>",11        "MACWHISPER_LOG_PATH": "<value>"12      }13    }14  }15}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.2.1

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Macwhisper

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Macwhisper?

Does Macwhisper need an API key?

What transport does Macwhisper use?

When was Macwhisper last checked?

Documentation