Docs

Setup

Install from Download (PKG installs app + drivers).
Open Settings → Readiness. Paste a Gemini or OpenAI API key (stored in your Mac Keychain). Free Gemini key guide →
Allow Accessibility (so Mávip can press Phone's Call button) and Microphone.
Install the audio driver if the PKG didn't (one admin prompt).
Type a goal and a number, press Call.

Placing calls

One call at a time, from your own iPhone number via Continuity.
The agent warms up while dialing, waits for the answer, then greets.
Tell it to end the call any time ("please hang up") or press End.
Every call saves a transcript + history entry; recordings are on by default.

Call list

Add contacts one at a time, or paste a list — one per line: +15551234567, Name, +15551234567, or Name <+15551234567>.
Each contact can have its own goal; otherwise the default goal is used.
Press Call next to work through the list one call at a time. Status (pending / done / failed) updates as you go.
Auto-advance (off by default) starts the next call after a short pause. Use it for your own errands only — never for bulk or unsolicited calling.

Transcripts & recordings

Every call saves a transcript; with "Record calls" on (default), it also saves a single mixed audio file of both sides.
Open any past call from Recent calls (main window) or History to read the transcript and play the audio.
Everything is stored on your Mac: ~/Library/Application Support/post.mavip.app/ (history.json, contacts.json, Recordings/).

CLI & MCP

The CLI and MCP server ship inside the app you already downloaded — no separate install: /Applications/Mavip.app/Contents/Resources/bin/mavip and .../mavip-mcp.

Add the CLI to your PATH (one-time), then use it. The Mávip app must be running — it owns the Accessibility/audio permissions:

sudo ln -s "/Applications/Mavip.app/Contents/Resources/bin/mavip" /usr/local/bin/mavip

mavip status
mavip call +15551234567 --goal "Book a table for two, Friday 7pm"
mavip list add +15551234567 --name Salon --goal "Book a haircut"
mavip list next
mavip recordings
mavip settings
mavip transcript
mavip hangup
mavip license

For an agent, point your MCP client at the absolute path /Applications/Mavip.app/Contents/Resources/bin/mavip-mcp. Tools include place_call, call_status, get_transcript, hang_up, list_calls, get_call, call_list, add_contact, import_contacts, call_next, list_recordings, play_recording, get_settings, set_setting, license_*, providers, check_updates. See them in the app under Settings → Automation. Everything runs locally over a user-only socket — nothing is exposed to the network.

License

3 free calls from first launch, then a one-time lifetime license (up to 3 Macs).
After purchase the app activates automatically via a mavip://activate link; you can also paste the key in Settings → Readiness.
On a new Mac, paste your license key from your purchase email to activate (a lifetime license covers up to 3 Macs). Deactivate frees a seat.
Validation is best-effort — the app keeps working offline; only an explicit revocation disables it.

Troubleshooting

Call button not pressed: re-grant Accessibility, then quit and reopen Mávip.
No audio / agent can't hear: reinstall drivers, then killall coreaudiod (or restart).
Key shows invalid: Settings → Readiness → Re-check; confirm the key works in the provider console.
Logs: ~/Library/Logs/Mavip/mavip.log.

Privacy

Everything stays on your Mac: call audio goes straight from your Mac to your AI provider using your own key, and transcripts, recordings, and your call list are stored locally. We never receive or store your calls. The only things that leave your Mac are provider requests and a license check. Full policy: Privacy Policy. Support: mavip-support@posterior.xyz.

Terms

One Pro license covers up to 3 Macs you own. No bulk dialing, no spoofing, no impersonation. Full terms: Terms of Service.

Open source

The audio driver is open source (GPLv3): github.com/amsterg/mavip-audio-driver.