Skip to main content
Glama
docdyhr

macwhisper-mcp-server

by docdyhr
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MACWHISPER_CLINoPath to the mw binary. Defaults to /Applications/MacWhisper.app/Contents/MacOS/mw if that file exists, otherwise mw on PATH
MACWHISPER_LOG_PATHNoLog file path (never stdout — that's reserved for MCP)~/Library/Logs/macwhisper-mcp.log
MACWHISPER_ALLOWED_PATHSNoColon-separated list of directories the server may read from~/Desktop

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
transcribe_audioA

Transcribe a local audio file using MacWhisper and return the transcript.

IMPORTANT: path must be a file on the user's Mac filesystem inside the configured allow-list (typically ~/Desktop or ~/Downloads). Files uploaded to the Claude chat window are NOT accessible — ask the user to save the file to their Desktop or Downloads folder first.

If this tool returns an access-denied error, do NOT attempt to transcribe the file by any other means (e.g. downloading a model, calling an external API, or using in-process speech recognition). Simply tell the user to save the file locally and retry with this tool.

cancel_transcriptionA

Cancel the currently running transcription, if any.

list_modelsA

Return the transcription models installed in MacWhisper.

Each entry is formatted as engine:model-id — Display Name [active] where [active] marks the model currently selected in MacWhisper. The engine:model-id string can be passed directly as the model argument to transcribe_audio.

list_allowed_pathsA

Return the directories this server is allowed to read audio from.

start_watchA

Start watching a folder for new audio files to auto-transcribe.

New audio files dropped into folder are transcribed automatically and moved to <folder>/../done/. Call get_watch_results() to retrieve completed transcriptions.

stop_watchA

Stop the active folder watcher.

get_watch_resultsA

Return completed watch-folder transcriptions and clear the queue.

Each entry contains: file, transcript, destination, error.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/docdyhr/macwhisper-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server