Macrophone

Docs

Every dictation that reaches your Mac can go straight into an app and be sent, be saved to a note, or go to a script, a webhook or an AI agent. Here is how it all works.

Sending into apps#

Your iPhone transcribes and cleans up what you say, then sends the text to Macrophone for Mac. A profile on the Mac decides what happens next. The headline trick is sending it straight into an app:

App targetingInto Claude, ChatGPT, Cursor or the Terminal tab running Claude Code, and sent, with 2.5 seconds to cancel. Voice prefixes and Send toSay “Claude, …”, pick a target by the mic, or let your Mac pick by the app in front. Templates and variablesWrap your words with the selection, window, URL, clipboard or date. SnippetsSay a short phrase, get something longer. Output formatsOne line, a code block, a quote, shell- or JSON-quoted. tmux panesType into a pane whatever app is in front. Obsidian, Notes, RemindersLog to your daily note, save a note, add a reminder with a due date. Ask ClaudeYour own API key, Claude's reply in the panel and on your clipboard.

For developers#

The Mac app also keeps a short history and offers it to other tools:

Local APIHTTP on 127.0.0.1. Get the latest dictation, list recent ones, long-poll or stream new ones. Command linemacrophone, or mp for short. Pipe your voice into anything. MCP serverGive Claude Code, Claude Desktop or any MCP client a tool that reads or waits for your dictation. Scripts and webhooksRun a shell command or POST JSON for every dictation.

On the iPhone, Shortcuts actions and controls start a dictation to a chosen target from the Action Button, Back Tap, Control Center or Siri, and can hand the text to your own shortcuts.

Quick start#

  1. Install Macrophone for Mac and the iPhone app, and pair them by scanning the QR code.
  2. In the Mac app's window, open the Developer pane and choose Install… next to Command-line tool. macOS asks for your password once.
  3. Dictate something on your iPhone, then run:
Terminal
mp            # prints your latest dictation
mp status     # shows the app version and which phones are connected

From there, add the MCP server to Claude Code, or follow a recipe:

Dictate into Claude CodeStraight into the Terminal tab running it, and sent. Or let Claude wait for your voice. Talk to Claude desktop hands-freeSay “Claude, …” and it's in a Claude chat and sent. Log to your Obsidian daily noteA timestamped line under today's heading, without opening Obsidian. Send every dictation to a webhookZapier, n8n, Make, Home Assistant or your own server.

Privacy for developers#

The API listens on 127.0.0.1 only, needs a token, and refuses any request that comes from a web browser, so no website can read what you dictate. Text leaves your Mac only through what you set up: an app you send it to, Ask Claude, a webhook or a script. The Mac app labels each profile that does (“Sends text off this Mac”). See the privacy policy.