Whisper Notes

Configuração

1. Baixe o Whisper Notes para Mac versão 1.5.5 ou posterior — versão DMG (não a Mac App Store).
2. Abra o aplicativo → Configurações → Integrações → ative CLI local e MCP.
3. Clique em Instalar CLI na mesma seção. Após uma solicitação de administrador, ele cria dois symlinks: /usr/local/bin/whispernotes e /usr/local/bin/wn (somente se esse nome estiver livre). Ele nunca edita sua configuração de shell ou PATH. Ambos os links apontam para a cópia em ~/Library/Application Support/WhisperNotes/bin, que o aplicativo atualiza a cada inicialização — você não precisa adicionar essa pasta ao seu PATH.

Os exemplos abaixo usam o alias curto wn. Se wn já estiver em uso no seu Mac (por exemplo, pelo WordNet), o comando completo whispernotes funciona da mesma forma.

Usar a CLI

$ wn status
WhisperNotes 1.5.5 (340) · SenseVoice Small · ready · 3081 notes

$ wn list --limit 3
9f3c21a8  2026-08-01 09:14  0:42   meeting   Weekly sync — pricing review
b2d84e07  2026-07-31 18:03  12:26  recorded  Idea dump on the walk home
5a1f9c33  2026-07-30 10:52  47:10  imported  interview-with-anna.m4a

$ wn transcribe ~/Desktop/standup.m4a
Morning standup. Sarah shipped the pricing page, Marco is blocked on the…
✓ done in 6.5s (46x realtime) — saved to WhisperNotes history

$ wn export --format md --audio --output-dir ~/Transcripts
✓ exported 312/312 transcript(s), 312 audio file(s) → /Users/you/Transcripts

As transcrições são impressas no stdout; progresso e erros vão para o stderr — é seguro usar pipes ou redirecionar qualquer coisa. Adicione --json para saída legível por máquina. Todo o resto está na referência de comandos.

Conectar o Claude ou qualquer agente de IA (MCP)

O servidor MCP está integrado ao mesmo binário — nada mais para instalar.

Claude Code — uma linha:

claude mcp add whispernotes -- whispernotes mcp

Claude Desktop — adicione isto a ~/Library/Application Support/Claude/claude_desktop_config.json e reinicie o Claude Desktop:

{
  "mcpServers": {
    "whispernotes": {
      "command": "/usr/local/bin/whispernotes",
      "args": ["mcp"]
    }
  }
}

Depois, basta perguntar:

• "Leia minhas últimas cinco transcrições e me diga o que devo acompanhar."
• "Encontre a reunião em que discutimos a fatura e rascunhe um e-mail de resposta."
• "Transcreva ~/Desktop/podcast.mp3 e extraia todos os itens de ação."

Observações:

• Qualquer cliente MCP local funciona da mesma forma — comando whispernotes, argumentos ["mcp"] (Cursor, etc.).
• Se o comando não for encontrado, use o caminho completo de which whispernotes — aplicativos GUI não leem o PATH do seu shell.
• O site claude.ai não consegue acessar servidores MCP locais — use o Claude Desktop.

O que você pode fazer com ele

# Summarize your latest recording with a local LLM
wn show latest | ollama run llama3 "Summarize the key points:"

# Transcribe an interview straight into the clipboard
wn transcribe interview.mp3 | pbcopy

# Who said what — speaker-labeled transcript of your last meeting
wn show latest --speakers

# Find that one conversation
wn search "quarterly review"

# Review only your meeting recordings
wn list --source meeting --limit 10

# Switch the transcription model, then see which languages it takes
wn models select sensevoice
wn language list

Referência de comandos

Comando	Opções	O que faz
status	—	Versão do aplicativo, modelo ativo, prontidão, contagem de notas
list	--limit N · --source T · --json	Transcrições recentes, mais novas primeiro
search <query>	--limit N · --json	Busca de texto completo no histórico, com trechos
show [id or latest]	--timestamps · --speakers · --max-chars N · --offset N · --json	Imprime uma transcrição (padrão: latest)
transcribe <file>	--json	Transcreve um arquivo de áudio ou vídeo e salva no histórico
export	--format txt or md · --output-dir DIR · --source T · --limit N · --audio · --speakers	Exporta transcrições em lote como arquivos, opcionalmente copiando o áudio junto
models	list · select <id>	Lista ou alterna modelos: parakeet, sensevoice, whisper-small, whisper-large-v3-turbo
language	list · select <code>	Lista ou alterna o idioma de transcrição — as opções seguem o modelo ativo
mcp	—	Executa o servidor MCP no stdio (para clientes de IA, não para humanos)
version · help	—	Versão da CLI · uso

Vale a pena saber:

• wn é um alias de conveniência para whispernotes — comandos idênticos. Scripts e agentes de IA devem chamar whispernotes, que sempre existe; o alias só é criado quando o nome está livre.
• Autodescoberta para agentes: whispernotes help imprime o uso completo; um comando mal utilizado responde com a linha de uso exata no stderr. --json sempre emite um único objeto ou array JSON no stdout.
• show aceita o ID completo ou apenas os primeiros 4+ caracteres, conforme mostrado por list — ou latest, que é o padrão.
• --speakers (em show e export) usa a detecção de falantes que você já executou no aplicativo; export silenciosamente volta para texto simples em notas sem ela.
• export grava arquivos com título por data (2026-08-01-1956 Standup.md), nunca sobrescreve e usa como padrão ./whispernotes-export; arquivos Markdown trazem data, duração, fonte e ID no topo.
• --source filtra por origem: recorded, imported, meeting ou fn (digitação por voz com a tecla Fn).
• transcribe usa o modelo e o idioma selecionados no aplicativo, e o resultado também é salvo no seu histórico.
• Se o Whisper Notes não estiver em execução, a CLI o inicia em segundo plano e aguarda até ~15 segundos.

Ferramentas MCP

Ferramenta	Parâmetros	Retorna
list_transcripts	limit (padrão 20) · source	Transcrições recentes com IDs, datas, títulos
search_transcripts	query (obrigatório) · limit	Correspondências de texto completo com trechos
get_transcript	id (obrigatório) · timestamps · speakers · max_chars · offset	Texto de uma transcrição
get_latest_transcript	timestamps · speakers	Sua transcrição mais recente
transcribe_file	path (obrigatório)	Transcreve um arquivo de áudio ou vídeo e salva no histórico
list_models	—	Modelos instalados e qual está ativo

Gravações longas são paginadas: quando uma transcrição excede max_chars, a resposta termina com um marcador explícito de truncamento informando ao agente de qual offset continuar — reuniões de uma hora nunca estouram a janela de contexto.

Privacidade e segurança

• O transporte é um socket de domínio Unix em ~/Library/Application Support/WhisperNotes/api.sock com permissões 0600 — sem porta TCP, sem interface de rede, inacessível de qualquer outra máquina.
• Desativado por padrão: nada é servido até você ativar a opção nas Configurações.
• Clientes MCP como o Claude pedem sua aprovação antes de cada chamada de ferramenta.
• A transcrição é executada no dispositivo com os mesmos mecanismos do aplicativo; os resultados são armazenados apenas no seu histórico local.

Solução de problemas

• command not found: whispernotes após a instalação — execute ls -l /usr/local/bin/whispernotes. Se estiver ausente, a solicitação de administrador foi cancelada: clique em Instalar CLI novamente em Configurações → Integrações. Se existir, /usr/local/bin não está no seu PATH: adicione export PATH="/usr/local/bin:$PATH" a ~/.zshrc e abra uma nova janela de terminal.
• "a API local está desativada" — ative Configurações → Integrações → CLI local e MCP no Whisper Notes. Isso se aplica instantaneamente, sem necessidade de reiniciar.
• "O WhisperNotes em execução não inclui suporte à API local" — seu aplicativo é anterior à API local. Atualize para 1.5.5 ou posterior pelo atualizador no aplicativo ou pelo DMG mais recente.
• A primeira transcrição demora para iniciar — o modelo pode ainda estar carregando; o servidor aguarda até que ele fique pronto. whispernotes status mostra loading model… até o mecanismo aquecer.

Veja também

• Baixar Whisper Notes para Mac (DMG)
• Changelog
• Política de privacidade
• Markdown bruto desta página para agentes: whispernotes.app/cli-mcp.md
• Perguntas ou ideias: support@whispernotes.app