Frequently Asked Questions

Spamurai is a desktop application for Windows, macOS, and Linux that uses artificial intelligence to automatically organize, classify, and filter your email. It acts as an intelligent intermediary between you and your email provider, separating important messages from spam, newsletters, and low-priority content.

Spamurai connects to your email accounts via Gmail OAuth or IMAP. It scans incoming and historical emails, classifies each one by importance (essential, urgent, informational, unknown, junk) and category (personal, work, finance, shopping, etc.), then automatically keeps or trashes emails based on configurable confidence thresholds. Ambiguous emails are placed in a review queue for your manual decision.

Spamurai is available as a desktop application for Windows (x86_64), macOS (Intel and Apple Silicon), and Linux (x86_64).

The Spamurai interface is currently available in English and Polish, with more languages planned.

Yes, Spamurai offers a free tier that includes basic email processing limits. You can upgrade to a paid plan for higher limits and additional features. You can also use your own AI provider (BYOK or Ollama) to bypass processing limits entirely.

Download Spamurai from our download page, install it, and sign in with your Google account or email. Then connect your email accounts and Spamurai will begin organizing your inbox.

Spamurai supports Gmail via OAuth 2.0 and any IMAP-compatible provider, including Outlook/Office 365, ProtonMail, Yahoo Mail, and custom mail servers.

Spamurai can read email headers and bodies, move emails to trash or restore them, permanently delete emails, apply labels (Gmail) or move to folders (IMAP), mark emails as read, and trigger one-click unsubscribe (RFC 8058) with your confirmation.

Spamurai cannot forward, copy, or extract emails outside the application. It cannot access your contacts, calendar, or other non-email data. It cannot send emails on your behalf.

Spamurai offers three AI provider options: Spamurai AI (server-hosted, uses your subscription quota), Google Gemini with your own API key (data goes directly to Google, no Spamurai limits), and Ollama for fully local processing (nothing leaves your device). You choose which provider to use.

Title classification (the default) only analyzes the email subject line and sender — no body content is needed. Body classification is optional and sends the full email body to your chosen AI provider for deeper analysis when title-only classification is ambiguous.

Filtering rules let you define automatic actions for emails matching specific criteria. Traditional rules match on sender email, sender domain, subject keywords or regex, category, or importance level. Rules can automatically keep, trash, archive, or skip emails.

AI rules use natural language descriptions like 'newsletters I never read' or 'receipts from online stores.' Traditional rules use structured criteria like sender domain or subject keywords. You can convert between the two formats — Spamurai can turn an AI rule into a structured rule and vice versa.

When Spamurai isn't confident enough to automatically act on an email, it places it in the review queue. You then manually decide to keep or trash it. Spamurai learns from these decisions and may propose new filtering rules based on patterns in your choices.

Spamurai offers several tiers — including a free plan and paid plans with higher limits. Each tier offers different daily email processing limits, number of linked accounts, history processing limits, and AI analysis calls. Visit our pricing page for current plans and prices.

Each email that Spamurai processes — classifies, filters, or trashes — counts toward your daily quota. Emails you handle manually in your email client don't count.

Spamurai pauses automatic processing until the next day. Your email still arrives normally in your email client — it just won't be auto-classified until your quota resets.

History credits let you process past emails in bulk. Each tier has a lifetime history limit. You also accumulate bonus history processing credits over time based on your tier's daily limit and your account limit (including any addon slots).

BYOK (Bring Your Own Key) lets you use your own Google Gemini API key for AI processing. This bypasses all Spamurai processing limits — you pay your AI provider directly. Your email data goes straight to Google's API, not through Spamurai servers.

Spamurai accepts card payments via Stripe in PLN, USD, and EUR. You choose your currency at checkout — all subsequent billing stays in that currency.

Upgrades take effect immediately. If you upgrade within the same currency, you receive prorated credit for the remaining days on your current plan and only pay the difference. If you switch currencies, a new full-price monthly billing period starts.

Downgrades between paid tiers take effect at the end of your current billing period, not immediately — you keep full access to your current tier's features until the period ends. Before confirming, you'll see a preview of how the change affects your linked accounts, history credits, team seats, and add-ons. Moving from a paid plan to Free isn't done as a downgrade — to switch to Free, cancel your subscription instead.

You receive a 3-day grace period with continued access. If payment is not resolved within 3 days, your account is automatically downgraded to the Free tier. Your data and settings are preserved.

You can cancel from the Billing section in your portal. Cancellation takes effect at the end of the current billing period — you keep full access until then. After that, you're downgraded to the Free tier.

All prices on the website and in the app are net prices (excluding tax). Depending on your country of residence, VAT or other applicable taxes may be added during checkout. The final amount including any taxes is shown before you confirm your payment.

No. Optional add-ons — extra history credits, additional linked-account slots, and Team Features — are available only on paid tiers (Coffee and Pro). To purchase an add-on, upgrade to a paid plan first. Add-ons are billed in the same currency and on the same monthly cycle as your subscription, and they are cancelled together with the subscription if you cancel.

Team Features are an optional paid add-on for Coffee and Pro plans. They turn your account into the owner of an organization that can host other Spamurai users as seat holders under your plan, sharing your seat pool and quota.

Team Features are available on Coffee and Pro tiers only. They cannot be purchased on the Free tier. You can purchase or cancel Team Features from the Billing section of your portal.

Your plan exposes a pool of seats that the whole organization shares. You can run the pool in two modes: Shared — all mailboxes draw from a single pool of daily, analysis, and history quota; or Split — each mailbox has its own per-mailbox caps. You can switch modes at any time from the Quota tab; stored caps are preserved across switches but are only enforced in Split mode.

From the Team page, create an invite scoped to anyone with the link, a specific email domain, or a specific email address. You can set a maximum number of redemptions and optional default per-mailbox caps. Pending invites don't reserve seats — capacity is checked when each invite is redeemed inside the Spamurai app.

The mailbox is paused immediately and moves back to the holder's personal organization. Their decision counter follows them, but the mailbox loses any history bonus tied to the team plan. The owner cannot read members' emails, see their rules, or act inside their inbox at any point — owners only see organization-level metadata (member email, linked date, mailbox caps, paused state).

Team Features are cancelled together with your subscription. At the end of the billing period, all seats are revoked and the affected mailboxes are paused until they are covered by another plan (their own subscription or another team owner's invite). Members' personal data and settings on their devices are unaffected.

Spamurai collects your account information (email, optional name), device information (device ID, app version), email metadata for AI classification (subject, sender — only when using Spamurai AI), usage statistics, and billing records. Full details are in our Privacy Policy.

No. Email bodies are never stored on Spamurai servers. When using Spamurai AI, email metadata (and optionally body content) is sent to our server for classification and forwarded to the AI provider, but it is not persisted. Email data is stored locally on your device only.

Spamurai includes keyword detection for sensitive terms related to medical, legal, banking, financial, password, and tax content. By default, email bodies containing sensitive content are not sent to the AI provider. You can configure this threshold in the app settings.

Email metadata (subject, sender, snippet) is sent to Spamurai's server and forwarded to Google Gemini for classification. If body classification is enabled, the full email body is also sent. This data transits through the AI but is never stored on our servers.

When you use your own Gemini API key, your email data goes directly to Google's API. It never passes through Spamurai servers. You are subject to Google's privacy policy for that data.

With Ollama, all AI processing runs entirely on your machine. No email data leaves your device whatsoever. This is the most private option.

Currently, account deletion requires an administrator request. Contact us at contact@spamurai.pro and we will process your request. On deletion, all your data is permanently removed from our database.

Yes. Spamurai is operated by a company based in the EU (Poland) and complies with the General Data Protection Regulation. You have the right to access, rectify, erase, and port your data. See our Privacy Policy for full details.

You can sign in with your Google account via OAuth, or use email one-time password (OTP) — we'll send you a 6-digit code that expires after 10 minutes. No password is needed.

Spamurai uses a one-active-device model by design. This ensures consistent rule application and prevents conflicting actions on your email. Activating Spamurai on a new device automatically deactivates the previous one.

When you activate Spamurai on a new device, the previous device is deactivated. Your settings, rules, and decisions sync to the new device automatically via the server.

Yes. The number of email accounts you can connect depends on your subscription tier: 1 on Free, 2 on Coffee, 3 on Pro, and more on higher tiers. You can mix Gmail and IMAP accounts.

Your device sends a periodic signal to the server to confirm it's still active. If no heartbeat is received within 24 hours, the device is considered inactive. This enables clean device switching.

Spamurai checks for updates on startup by contacting the update server. Updates are cryptographically signed for security. You are prompted before installation, and the app restarts after updating.

Spamurai stores data in a SQLite database in your app config directory (typically ~/.config/com.spamurai.desktop/). This includes cached email headers, filtering rules, decision history, and app settings. Credentials (OAuth tokens, passwords, API keys) are stored in your operating system's native keychain.

Spamurai requires file system access (app config directory only), network access (email providers, Spamurai API, your chosen AI provider), and system keychain access for credential storage. It does NOT require microphone, camera, contacts, calendar, location, clipboard, or access to other applications.

Public endpoints: 60 requests/minute per IP. Update checks: 120 requests/minute per IP. Authentication OTP requests: 5 per 10 minutes per IP. Write operations: 60 per minute per IP. Decision batches: max 500 per request.

Contact us at contact@spamurai.pro or use the contact form on our website. Please include your app version, operating system, and a description of the issue or request.