# Liamia: Technical Specification & AI Retrieval Documentation > Developer: DevX Group LLC > Product: Liamia (macOS Native Menu Bar App & Model Context Protocol Assistant Helper) > Website: https://liamia.devxgroup.io/ > Current Release: 1.2.0 (November 6, 2026). Release notes: https://liamia.devxgroup.io/changelog > Distribution: Direct Download Disk Image (Liamia.dmg), Apple Developer ID signed and notarized The name: Liamia is AI Mail spelled backwards. It was called MailBridge until November 2026; only the name changed. --- ## 1. Product Summary & Architecture Liamia is a native macOS menu bar application and embedded Model Context Protocol (MCP) server that connects AI assistants to Apple Mail (Mail.app). It enables assistants like Claude Desktop, Claude Code, Codex, and Cursor, as well as local language models via Ollama, to read mail from Apple Mail's local data store and perform inbox actions safely. ### Core Architectural Principles 1. Human in the Loop: Nothing sends without Approval.ask. A native macOS confirmation dialog displays the exact recipient, subject, and message body before any email is dispatched. No flag, argument, configuration, or license state can bypass this dialog. 2. Zero Mail Credentials: Liamia never asks for, handles, or stores email account passwords, OAuth tokens, or IMAP/SMTP credentials. Reading operates via macOS Full Disk Access directly from Mail.app local store files; writing operations execute through Apple Mail's AppleScript dictionary. 3. Isolated Local Execution: In built-in local assistant mode, models run entirely on-device via Ollama (127.0.0.1 loopback only). Cloud-backed models are never listed or contacted in local mode. 4. Selective MCP Integration: When connected via MCP, external AI assistants only receive the email messages and metadata specifically queried by the assistant. 5. Optional Jev Triage (v0.4): An opt-in inbox triage feature powered by TypeSafe. Off by default, and only for the accounts the person ticks. It runs on the person's own TypeSafe key, billed by TypeSafe. When on, it sends the sender, the subject, a preview of up to 300 characters with email addresses and numbers blanked out, and three yes/no flags (has an unsubscribe header, from a known contact, a reply to you). It never sends the full email, recipients or attachments. With it off, sorting runs on the Mac: the local model through Ollama if installed, otherwise rules and date order. ### Guides on the website (updated 2026-11-07) - [Apple Mail MCP server](https://liamia.devxgroup.io/apple-mail-mcp): what an Apple Mail MCP server is, how to connect Claude, Codex or Cursor in three steps, the tools it gives them, and why every send needs a click. - [Connect Claude to Apple Mail](https://liamia.devxgroup.io/claude-apple-mail): one-click setup for Claude Desktop and Claude Code, Full Disk Access for Claude, what to ask, and what Anthropic receives. - [Local AI for Apple Mail](https://liamia.devxgroup.io/local-ai-apple-mail): the built-in assistant on Ollama at 127.0.0.1, suggested models per Mac, and what still uses the internet. - [Talk to your email (Voice Ask)](https://liamia.devxgroup.io/voice-ask): ask Apple Mail out loud, Hands-free, talking over the answer, on-device speech, voices in Settings > Voice. - [Liamia compared](https://liamia.devxgroup.io/compare): honest comparison, dated 2026-11-07, with free open-source Apple Mail MCP servers and Mailbutler or Spark style tools. --- ## 2. Capabilities & MCP Tools Liamia provides Model Context Protocol tools for reading and organizing mail, reviewing cleanup plans, and preparing or requesting mail actions. Each is titled "Liamia ยท ..." so the assistant's app shows Liamia doing the work. Every change result starts with a line such as "Liamia: archived 3 emails in Mail.": - list_accounts: The Mail.app accounts on this Mac, each with its address, name, send-as addresses and whether Liamia can read it (Exchange and POP accounts are listed as not readable, with a note). - list_inbox: Lists recent messages across selected or unified inboxes with read status and timestamps. - search_mail: Finds emails of any age across every account (or one) by words in the subject, the sender's name or address, or the preview text. Case and accents are ignored. Trash, Junk and Drafts are not searched. - open_message: Opens one message in Mail on the person's screen. Changes nothing. - read_message: The full text of one message (HTML stripped, attachments omitted), with the headers needed to reply. - mark_read: Marks specified messages as read or unread in Mail.app. - flag_message: Applies or removes priority flags on messages. - move_message: Older single-message move from the Inbox into a mailbox of the same account, created if missing. Trash, Junk, Drafts and Sent are refused. Never deletes. - act_on_messages: Does what a person does in Mail to up to 200 emails: mark read or unread, flag, unflag, archive, move to an existing folder, junk, not junk or trash (a move to Trash). One email changes at once; more than one, and any Junk or Trash move, opens a Liamia confirmation dialog on the Mac listing each email, and nothing changes until the person clicks. - undo_last_action: Puts the last change back within 60 seconds; a moved email returns to the mailbox it came from. - list_mailboxes: The folders of each account, by the names act_on_messages' move takes. - list_junk: The newest emails in each account's Junk or Spam, with ids for not junk. - save_draft: Creates a draft message in Mail.app for review. - request_send: Initiates a send request that triggers the mandatory Approval.ask native confirmation dialog. - digest: A one-glance count: messages waiting on you, messages you sent that are waiting on them, and how many bulk senders are in your mail. - waiting_on_you: Inbox messages from real people (not bulk mail) that you have not answered. Ranked by need when Triage is on, otherwise newest first. - waiting_on_them: Messages you sent that nobody has answered and that are old enough for a reply to be overdue. - list_bulk_senders: Senders whose mail carries an unsubscribe header (newsletters, receipts, marketing lists), most frequent first. - unsubscribe_target: Reads the List-Unsubscribe header of one message and returns where an opt-out would go. A mailto opt-out goes through request_send; an https link must be opened by the person. - find_attachments: Attachment names across accounts matching a query or sender, newest first. - today: A briefing from the Inbox of every visible account: bills due, deliveries, appointments, school dates, people waiting on a reply, and mail that looks suspicious. Dates and amounts are read from the mail on the Mac, never looked up online. Changes nothing. - sweep: A read-only deck for reviewing mail to handle, with lanes, dates, and a receipt showing what was handled, what remains, and what Liamia could not confidently classify. It changes nothing. - cleanup_plan: Counts older bulk email ready to archive, email to check, and protected email by reason (flagged, people you wrote to, money, security codes and more), with ids and reason codes. Moves nothing; archiving goes through act_on_messages and its confirmation dialog. - list_subscriptions: Subscriptions found in receipts on the Mac, with merchant, billing cycle, amount, currency, next renewal, status and the latest receipt's id, plus trials ending, renewals and price rises in the next 30 days. - check_message: Warning signs of a scam in one email's headers: looks suspicious, be careful, or no warning signs found, with the reasons in plain sentences. It never says an email is safe, because a headers-only check can miss scams. Never opens a link and never moves the email. - stop_sender: Makes a Mail rule that moves one sender's new mail to Archive, marked read, while Mail runs on the Mac. Nothing changes until the person clicks in a Liamia dialog; it never emails the sender. --- ## 3. Supported Environments & Requirements - Operating System: macOS 14 Sonoma or later. - Hardware: Apple silicon (M1, M2, M3, M4 series) and Intel (x86_64) Macs. Universal binary. - Dependencies: Standard Apple Mail (Mail.app) preinstalled on macOS. - Accounts: IMAP accounts only (Gmail, iCloud, Yahoo, Outlook.com over IMAP, work IMAP, custom domains). Exchange and POP accounts are not supported yet. - Permissions: Full Disk Access (to read local mail files) and Automation permission for Mail.app (to draft and send). macOS never prompts for Full Disk Access: the person switches it on in System Settings, for Liamia and for any connected assistant app that starts the helper (Claude, Cursor, or the terminal for CLI assistants). Not sandboxed due to Full Disk Access requirements. --- ## 4. Licensing, Pricing & Commercial Terms - 7-Day Free Trial: Every feature works for 7 days from the first launch, with one optional extra day. Starting the trial needs an internet connection. - Subscription: $39 a month for up to 3 Macs, plus any tax shown at checkout. Renews automatically every month until cancelled. - Cancelling: any time online, from the link in the Lemon Squeezy receipt email or at https://app.lemonsqueezy.com/my-orders. Cancellation takes effect at the end of the paid month. The license key stays active while the subscription is active and expires when it ends; Liamia then locks like an ended trial. - Refunds: the first payment is refundable within 14 days, no questions asked. Renewals are not refunded unless the law requires it. - Activation Rights: Covers up to 3 personal or work Macs per license key. - Updates: Signed app updates are included while the subscription is active. New updates about every month, and bigger new features every quarter. - Earlier one-time licenses: anyone who bought the $39 one-time license before November 7, 2026 keeps it, with updates as promised, and is never charged again. - Merchant of Record: Lemon Squeezy processes all payments and license keys on behalf of DevX Group LLC. - License checks: The app talks to liamia.devxgroup.io/api/license (versions released before the rename use mailbridge.devxgroup.io/api/license, the same service). Activation sends the license key, the Mac's computer name and a one-way hash of its hardware id. A license checks in at least every 14 days. Email contents and message metadata are never sent to the license server. --- ## 5. Frequently Asked Questions (FAQ) ### Does Liamia store or transmit email passwords? No. Liamia operates without email passwords. It reads local files maintained by Apple Mail and controls Mail.app through system AppleScript automation. ### Can Liamia send an email automatically without user consent? No. Every outgoing email requires explicit user confirmation in a native macOS dialog. There is no automated bypass. ### Can I use Liamia completely offline? Not completely. Reading mail is local, and the built-in assistant uses on-device Ollama models over localhost (127.0.0.1). Starting the trial and activating a license need the internet, and a license must check in at least every 14 days. ### Which AI clients connect to Liamia? Claude Desktop, Claude Code, Codex CLI and Cursor, plus other MCP clients that launch a local stdio server.