Privacy policy
Familiar is a desktop mail and calendar client, developed by Marc Stevenson and published as open source at github.com/marcsstevenson/familiar-client. This policy explains what data Familiar accesses, where it goes, and the choices you have. "We" means the developer of Familiar.
- Familiar runs on your computer. There are no Familiar servers, and we never receive your mail, calendar, contacts or sign-in tokens.
- Your data goes only between your computer and your mail provider (Google or Microsoft), and is stored on your computer.
- Familiar has no analytics, telemetry, advertising or tracking, and we never sell or share your data.
- Optional AI features are off until you turn them on, and then send only the one email you ask about, through an AI tool you have chosen and signed in to yourself.
What Familiar accesses
When you add an account, you sign in on your provider's own sign-in page and grant Familiar access. Familiar then uses that access to show and manage, on your computer, your:
- Mail: messages, attachments, folders or labels, drafts, and the addresses you send from.
- Calendars: your calendars and their events, including invitations and your replies to them.
- Contacts: your saved contacts and the addresses your provider keeps from past mail, used to suggest recipients as you type.
- Basic profile: your name and email address, to label the account.
Familiar only reads or changes this data when you, or a tool you have allowed on your own computer, ask it to, or when it syncs in the background to keep your local copy up to date.
Google user data
For Gmail accounts, Familiar uses the Gmail API, the Google Calendar API and the Google People API, and asks for these permissions:
| Permission | What Familiar does with it |
|---|---|
openid, email, profile | Identifies which Google account you signed in with and shows its name and address. |
gmail.modify | Syncs your mail to your computer, and carries out what you do in Familiar: mark read or unread, star, label, archive, move to Trash, and save drafts. It cannot permanently delete mail. |
gmail.send | Sends the mail you write and choose to send. |
gmail.settings.basic | Reads your send-as addresses and their signatures, so you can send from them, and keeps the Gmail filters you set up in Familiar's rules in step with Gmail. |
calendar | Syncs your calendars and events, and creates, changes or replies to events when you ask. |
contacts.readonly, contacts.other.readonly | Reads your contacts and Google's saved "other contacts" to suggest recipients. Familiar never changes your contacts. |
How Google user data is used, stored and shared
- Use: Google user data is used only to provide Familiar's features to you, in the app and its command line on your computer. It is not used for advertising, profiling, credit decisions or any purpose other than showing and managing your own mail, calendar and contacts.
- Storage: data received from Google is stored only on your computer, in Familiar's local database and search index inside your user folder. It is never sent to or stored on a server run by us. Your Google sign-in tokens are kept in your operating system's keychain (Windows Credential Manager, macOS Keychain or the Linux Secret Service), or in an encrypted file if you choose that for a machine with no keychain.
- Transfer: Familiar sends Google user data to nobody except Google itself, apart from the one case you control in "Optional AI features" below. We do not sell it, and we do not share it with advertisers, data brokers or anyone else.
- Human access: nobody other than you reads your data. We have no access to it, because it never leaves your computer for us.
- AI and machine learning: Google user data is not used to develop, improve or train generalised or non-personalised AI or machine-learning models, by us or, through Familiar, by anyone else.
Familiar's use and transfer to any other app of information received from Google APIs will adhere to the Google API Services User Data Policy, including the Limited Use requirements.
Microsoft accounts
For Outlook.com, Hotmail and Microsoft 365 accounts, Familiar uses Microsoft Graph in the same way: mail, calendars and contacts are synced straight between your computer and Microsoft, stored only on your computer, and used only to provide Familiar's features to you.
Optional AI features
Familiar has two optional features that use an AI model: finding calendar events in an email, and a second opinion on whether an email is spam or a scam. Both are off by default. Nothing is sent to any AI service unless you turn them on in Familiar's settings file, and you can limit them to chosen accounts.
When they are on, Familiar does not contact an AI service itself. It passes the email you asked about to an AI command-line tool that you have installed and signed in to yourself (Anthropic's Claude Code or OpenAI's Codex). That tool sends it to its provider under your own account and that provider's terms. What is passed is limited to that one email: its subject, sender, date, up to 20,000 characters of its text, and the names of its attachments. For finding events, that text can include the text of its PDF attachments. For the spam check, it also includes the email's Reply-To address, number of recipients and links, and facts Familiar works out about it, such as its sender-authentication results and whether you have written to the sender before. No other mail, calendar or contact data is sent. We never receive it, and never see your AI tool's sign-in. AI features are user-facing only, run when you ask (or, for the spam check, only if you also turn on background checking), and are never used to train models by us.
AI agents on your computer
Familiar has a command line and a built-in MCP server, so you can let AI assistants you run, such as Claude Code, use your mail and calendar. This only happens if you set it up. By default an agent can read and save drafts; sending, deleting and other changes need a permission you add to your settings file, and every change is written to a local audit log you can view with fam audit list. Data an agent reads is handled under the terms of the agent you chose.
Data we collect
None. Familiar has no accounts with us, no analytics, no crash reporting and no telemetry. It connects only to your mail providers, and to an AI tool's provider when you have turned AI features on.
This website is a static site hosted on Cloudflare. It sets no cookies and runs no analytics or tracking scripts. Cloudflare may keep standard technical logs, such as IP addresses, to deliver and protect the site.
Keeping and deleting your data
Your data stays on your computer until you remove it. You can:
- Sign out of an account with
fam auth logout <account>(or every account with--all), which deletes its tokens from your computer. - Revoke Familiar's access to your Google account at any time at myaccount.google.com/permissions, or to your Microsoft account at account.live.com/consent/Manage.
- Delete Familiar's data folder (
.familiar\datain your user folder on Windows, and your system's local application data folder, underFamiliar, on macOS and Linux) to remove all synced mail, calendars, contacts and the search index. Uninstalling the app and deleting this folder removes everything Familiar stored.
Because we hold none of your data, there is nothing for us to delete on our side, but we're happy to help if you have questions.
Security
Familiar connects to Google and Microsoft only over HTTPS, signs in with OAuth and PKCE so it never sees your password, and keeps tokens in your operating system's secure storage. Its source code is public, so anyone can check what it does.
Children
Familiar is not directed at children under 13 and does not knowingly collect data from them.
Changes to this policy
If this policy changes, the new version will be posted on this page with a new effective date. Earlier versions are kept in the project's public history on GitHub.
Contact
Questions about this policy or your data: privacy@familiarclient.com.