Quick Start
Welcome to MailPrism. This guide takes you from zero to your first working automation in about five minutes.
MailPrism is invite-only right now.
- Have an invite? Open your invite link — it takes you to sign-up with your invite code filled in.
- No invite yet? Join the waitlist at app.mailprism.ai/beta.
Each invite code works once. When you use it, it's tied to the email you sign up with — if you sign up with Google, enter the address of the Google account you'll pick.
An invite, a Gmail account (personal or Google Workspace), and a few minutes.
The three steps
MailPrism's onboarding is just three steps. Do them in order and you're done.
1. Create your account
Open your invite link (or go to app.mailprism.ai and choose sign-up). The form asks for:
- Your email — for Google sign-up, the address of the Google account you'll choose.
- Your beta invite code, if the invite link didn't fill it in.
- Your consent to AI processing. MailPrism uses AI providers (Google Gemini as the primary provider, with OpenAI as the fallback) to analyze your email. You can turn AI off later in Settings → Privacy → AI Data Processing — see AI privacy & consent.
You'll then land in a short setup flow that walks you through the next two steps.
2. Connect Gmail
Click Connect Gmail. Google asks you to choose your account and approve the access MailPrism needs to read and organize your mail.
This uses Google's standard OAuth — MailPrism never sees your Google password.
During the beta, Google may show this warning when you connect Gmail. That's expected: Google's verification of MailPrism is still in progress. To continue, click Advanced, then Go to MailPrism (unsafe), and review the permissions as normal. Google shows this warning when an app asks for sensitive or restricted Gmail access that Google hasn't finished verifying. Before you continue, check that the app name says MailPrism and the access requested matches what's described on Connecting Gmail.
→ Full details, including what each permission means: Connecting Gmail
3. Create your first rule
A rule is a simple "when this email arrives, do that" instruction. You can build one from scratch or start from the Rule Library of ready-made templates.
Create Rule opens on the AI drafter: describe what you want ("label newsletters and archive them"), review the draft, then create it. To build it yourself instead:
- Open Rules → Create Rule and choose Rule builder.
- Add a condition — for example, From contains
newsletter. - Add an action — for example, Apply label
Newsletters, then Archive. - Save and enable it.
→ A guided walkthrough: Create your first rule
That's it — onboarding is complete and your automation is live.
What happens next
When a new email matches a rule, the rule's actions run automatically. MailPrism listens for Gmail's own notifications about new mail, so rules usually run within moments of an email arriving.
Timing controls live in Settings → Rule Defaults & Safety: the Quiet Hours card pauses rule processing during a window, and the Execution Settings card's batch size, cooldown, and rate limits keep big runs in check. (The Processing frequency option there currently only paces MailPrism's scheduled background runs — see How often rules run.)
You can watch everything it does in Analytics and the Rule Logs, and you can pause or change any rule at any time.
→ Fine-tune timing, quiet hours, and batch size: How rules work
Where to go next
| If you want to… | Read |
|---|---|
| Understand how rules really work | How rules work |
| See every condition you can match on | Conditions reference |
| See every action a rule can take | Actions reference |
| Let AI sort by urgency, category, and tone | AI features |
| Get comfortable with the dashboard | Your dashboard |
Email hello@mailprism.ai — beta feedback is very welcome. You can also browse the FAQ and Troubleshooting guides.