Local API

Authorization: Bearer mp_…

{"port":47820,"token":"mp_…"}

CFG="$HOME/Library/Application Support/Macrophone/api.json"
MP_PORT=$(plutil -extract port raw "$CFG")
MP_TOKEN=$(plutil -extract token raw "$CFG")
curl -s -H "Authorization: Bearer $MP_TOKEN" "http://127.0.0.1:$MP_PORT/v1/latest"

{
  "cleaned": "Refactor the upload handler so retries back off exponentially, and add a test for the timeout case.",
  "cleanup_level": "medium",
  "created_at": "2026-10-12T20:41:03Z",
  "delayed": false,
  "id": "6F1C2A7E-3B4D-4C55-9A0E-2D8F1B7C9E10",
  "language": "en-US",
  "profile": "Claude Code (Terminal)",
  "raw": "So um refactor the upload handler so that it no so retries back off exponentially and add a test for uh the timeout case",
  "received_at": "2026-10-12T20:41:04Z",
  "reply": null,
  "source_device": "Alex's iPhone",
  "stopped_early": false,
  "text": "Refactor the upload handler so retries back off exponentially, and add a test for the timeout case."
}

mp wait --json | jq -r .text     # your words arrive (reply is still null here)
sleep 10                          # give Claude a moment to answer
mp latest --json | jq -r .reply   # Claude's answer

curl -s -H "Authorization: Bearer $MP_TOKEN" http://127.0.0.1:47820/v1/latest

curl -s -H "Authorization: Bearer $MP_TOKEN" "http://127.0.0.1:47820/v1/history?limit=5"

{"items":[ { …dictation… }, { …dictation… } ]}

curl -s -H "Authorization: Bearer $MP_TOKEN" "http://127.0.0.1:47820/v1/next?timeout=120"

curl -sN -H "Authorization: Bearer $MP_TOKEN" http://127.0.0.1:47820/v1/stream

: keep-alive

event: dictation
data: {"cleaned":"Ship it.","cleanup_level":"medium","created_at":"2026-10-12T20:44:10Z", … ,"reply":null, … }

{
  "app_version": "1.0",
  "api_version": 1,
  "history_enabled": true,
  "phones": [
    { "name": "Alex's iPhone", "connected": true, "last_seen": "2026-10-12T20:41:04Z" }
  ]
}

{"error":"…"}

import json, pathlib, urllib.request

cfg = json.loads((pathlib.Path.home() / "Library/Application Support/Macrophone/api.json").read_text())
base = f"http://127.0.0.1:{cfg['port']}"

def get(path, timeout=10):
    req = urllib.request.Request(base + path, headers={"Authorization": f"Bearer {cfg['token']}"})
    with urllib.request.urlopen(req, timeout=timeout) as r:
        return None if r.status == 204 else json.load(r)

latest = get("/v1/latest")
after = latest["id"] if latest else None

while True:
    query = "/v1/next?timeout=300" + (f"&after={after}" if after else "")
    item = get(query, timeout=310)
    if item:
        after = item["id"]
        print(item["text"], flush=True)

import { readFile } from 'node:fs/promises';
import { homedir } from 'node:os';

const cfg = JSON.parse(await readFile(`${homedir()}/Library/Application Support/Macrophone/api.json`, 'utf8'));
const res = await fetch(`http://127.0.0.1:${cfg.port}/v1/stream`, {
  headers: { Authorization: `Bearer ${cfg.token}` },
});

const decoder = new TextDecoder();
let buffer = '';
for await (const chunk of res.body) {
  buffer += decoder.decode(chunk, { stream: true });
  let end;
  while ((end = buffer.indexOf('\n\n')) !== -1) {
    const event = buffer.slice(0, end);
    buffer = buffer.slice(end + 2);
    const data = event.split('\n').find((line) => line.startsWith('data: '));
    if (data) console.log(JSON.parse(data.slice(6)).text);
  }
}

# The raw transcript of the last dictation
curl -s -H "Authorization: Bearer $MP_TOKEN" http://127.0.0.1:47820/v1/latest | jq -r .raw

# Texts of the last 10, oldest first
curl -s -H "Authorization: Bearer $MP_TOKEN" "http://127.0.0.1:47820/v1/history?limit=10" | jq -r '.items | reverse | .[].text'