Help

Setting up Metatron, using it every day, and fixing the usual problems. Can't find your answer? Write to support@usemetatron.com.

Getting started

Open the downloaded file and drag Metatron into Applications. It needs a Mac with Apple Silicon and macOS 26 or later.
Open Metatron. The first screen walks you through everything in a few minutes.
Allow what it asks for. Each permission has one job:
- Microphone: hears you after you say its name.
- Speech Recognition: turns your voice into text, on your Mac.
- Calendar: knows your meetings, so it can prepare you and give you a heads-up.
- Screen Recording: hears the call audio it transcribes, and takes screenshots when you ask. Nothing is recorded unless you're on a call or you ask.
- Accessibility: reads a chat when you ask about it. It never types or sends anything.
Pick your work folder. This is where your notes, to-dos and call summaries go, as plain Markdown files. Use a new folder, or an Obsidian vault you already have.

You can change any of this later in Settings.

Choosing your AI

Speech to text always runs on your Mac. For notes, answers and planning, Metatron uses the AI you choose in Connectors → AI model:

Claude: through Claude Code, signed in with your Claude plan or your own Anthropic API key.
ChatGPT: through Codex, signed in with your ChatGPT plan.
Local: a model running on your Mac with Ollama. Nothing leaves your computer. Install Ollama, then download the model Metatron suggests (a few GB, once). A Mac with 16 GB of memory or more works best.

Your plan or key is billed by that provider. Metatron never sees your payment details for them.

Every day

Talk to it. Say "Metatron", then what you need: "what's on today", "add a to-do to send Dana the plan", "what did Sam promise on Tuesday's call".
Ask from any app. Press Option + Space to type a question, with what's on your screen attached.
Calls. When a call starts in Zoom, Teams, Slack, FaceTime or Google Meet in Chrome, Metatron takes notes and tells you. Say "Metatron, stop transcribing" to stop. Afterwards the summary, decisions and to-dos land in your work folder.
To-dos. Everything you owe and everything owed to you is on the To-dos page. Metatron asks before it changes one.

Recording laws differ by place. Metatron reminds you to tell people a call is being transcribed; what you must do depends on where you and they are.

Reminders and sounds

Say "Metatron, remind me at 3 to call the bank", or "in 20 minutes", or "tomorrow morning". A card pops up at that time and stays until you press Done or Snooze.
Before calls with other people you get a heads-up card with the join link. Choose 5, 10 or 15 minutes, or off, in Settings → Alerts.
Pick the sound for pop-ups in Settings → Alerts, or switch sounds off. Quiet hours stop alerts, except reminders you set yourself.

Your licence

After buying you get a licence key by email. Paste it in Settings → Licence. There's no account to create.
One licence is for one person, on one of their Apple devices.
New Mac? Press Remove from this Mac on the old one, then paste the key on the new one.
Metatron checks the key about once a week, and keeps working offline for 30 days between checks.
A standard licence includes a year of updates. After that, the version you have keeps working for good; renew if you want newer versions. Founding member licences get every version.
Lost your key? Search your email for the Lemon Squeezy receipt, or write to us.

When something's wrong

It doesn't hear me say "Metatron"

Check Settings → Permissions: Microphone and Speech Recognition must be on. Make sure the right microphone is selected in System Settings → Sound. Speak at a normal volume; a noisy room or a far away mic can miss it.

A call wasn't transcribed

Screen Recording must be allowed. In System Settings → Privacy & Security → Screen & System Audio Recording, switch Metatron off and on again, then reopen it. Calls in a browser other than Chrome may not be noticed; say "Metatron, transcribe this meeting" to start by hand.

Permissions stopped working after an update

macOS sometimes asks again after an app updates. Open Settings → Permissions and allow anything that shows as off.

"The local AI isn't running"

Open Ollama, and check that the model shown in Connectors → AI model is downloaded. Settings tells you which one is missing and the command to get it.

Notes are slow or answers fail

Your AI provider may be busy, or your plan's limit reached. Check that you're signed in to Claude Code or Codex, or try again in a few minutes. Your recording is kept, and the notes are made when it works again.

The licence key won't activate

Copy the whole key with no spaces. If it says the key is already in use, remove it from the other Mac first (Settings → Licence → Remove from this Mac). Still stuck? Write to us with your order email.

Removing Metatron

Remove the licence from this Mac first (Settings → Licence), so you can use it elsewhere. Then quit Metatron and drag it from Applications to the Trash. Your work folder stays where it is: those are your files. To remove Metatron's own settings and recordings too, delete ~/Library/Application Support/Metatron.