Gmail Inbox Intelligence

Reply tracking, SLA monitoring, and unread digests for your Gmail — without a scraper, without a bulk sender, without storing your mailbox.

LICENSE

A free, MIT-licensed Apify Actor for Gmail inbox workflow analytics — thread search, reply tracking, LLM summary, unread digest. Built on gmail.readonly OAuth scope. Not a scraper, not a bulk sender, not a mailbox archiver.

30-second start

1. Click Run on apify.com/foxck/gmail-inbox-intel (or apify call foxck/gmail-inbox-intel from CLI)
2. Paste 3 OAuth fields (refresh_token, client_id, client_secret) — see OAUTH.md for the 5-minute Google Cloud setup
3. Read the dataset — for reply_metrics, you get stalled threads ranked by SLA breach age, ready to paste into Friday triage

No subscription. No server-side mailbox cache. The Actor runs against the official Gmail API in readonly scope and exits.

📖 Design notes on dev.to — series index:

• Apify Actor for Gmail inbox analytics: refresh-token-only OAuth, async router, per-feature quota
• Gmail OAuth client_id is not a secret — design notes for self-host Actors
• Why refresh-token-only OAuth for a multi-tenant Apify Actor
• Per-feature quota in Apify KeyValueStore — no DB, no cron, no drift
• Open-sourcing an MIT Apify Actor in 24 hours — a build log

💬 Discussions — design questions, roadmap, open trade-offs. 🗺️ ROADMAP.md — what's planned, what's speculative, what's explicitly out of scope. 📝 CHANGELOG.md — what changed in each release. 💝 Gumroad listing — pay-what-you-want download + email updates when new releases ship.

Don't want to self-host? If you have < 50 active client threads, the manual setup is probably easier: Freelancer Gmail Client Tracking Pack — $9 — 30 labels + 12 filters + 5 follow-up email templates + Apps Script. Setup in 20 min, no CRM, no subscription. Same SLA-breach detection, manual version.

Features

• thread_search — search Gmail threads by query, paginate, return metadata + message counts
• reply_metrics — for each thread, compute reply-from-me / reply-from-others / last reply age / SLA breach flag
• summarizer — optional OpenAI LLM thread summary (you supply your own API key)
• unread_digest — list unread threads in last N hours, grouped by label

Use Cases

• Freelancer Friday triage: reply_metrics against from:client-domains newer_than:21d, sort by last_reply_age_days desc, send Day-3/7/14 bumps to anything past the threshold. Replaces a CRM if you have < 50 active threads.
• Sales / BD pipeline rot: reply_metrics against label:outbound weekly, alert when reply_from_other is empty 14d+. Cheaper than HubSpot for a small list.
• PM / Ops morning digest: unread_digest against the last 12h grouped by label. Cron from Apify schedule → email yourself the dataset URL.
• Personal weekly review: thread_search for is:starred OR label:important newer_than:7d → triage backlog without forwarding emails to a third party.

Privacy & OAuth

• You provide your own OAuth credentials in Actor input (refresh_token + client_id + client_secret)
• Refresh-token-only flow — Actor exchanges for short-lived access token in memory each run
• Job-end state is cleared (best effort)
• We never store your Gmail. Every run uses your own OAuth, no server-side mailbox cache.

Pricing

Free. MIT licensed. Run it on Apify (their compute-unit pricing applies — usually pennies per run) or fork and run on your own box.

The repo includes a free_tier_user_id quota hook for future-self if you want to wrap it as a paid SaaS, but no billing layer ships with this Actor. If you'd rather pay for a setup instead of self-hosting OAuth, the $9 manual companion pack below skips OAuth entirely.

Input Schema (8 fields)

Field	Type	Required	Notes
feature	enum	yes	thread_search / reply_metrics / summarizer / unread_digest
oauth_token	object	yes	{refresh_token, client_id, client_secret}
query	string	no	Gmail search query (default in:inbox)
max_results	integer	no	default 50, max 500
openai_api_key	string	no	required only for summarizer
summary_model	string	no	default gpt-4o-mini
free_tier_user_id	string	no	for free-tier quota tracking
dry_run	boolean	no	skip Gmail API calls (test mode)

See .actor/INPUT_SCHEMA.json for full spec, and examples/ for 5 ready-to-paste input JSON files per feature.

Local Dev

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pytest               # 6 tests, asyncio_mode=auto
apify run            # local actor run with .actor/INPUT_SCHEMA.json

Related Projects

Looking for ready-to-import Gmail / AI / n8n templates? Some Gumroad workflows that pair well with this Actor:

• AI Lead Auto-Responder — Gmail → AI replies n8n workflow: https://foxck.gumroad.com/l/ai-lead-responder
• AI Content Pipeline — RSS → Social Media n8n template: https://foxck.gumroad.com/l/ai-content-pipeline
• Competitor Monitor — Daily AI analysis + weekly reports n8n: https://foxck.gumroad.com/l/competitor-monitor
• Claude Code Mastery — practical playbook for Claude Code workflows: https://foxck.gumroad.com/l/claude-code-mastery

Full catalog: https://foxck.gumroad.com

License

MIT — see LICENSE.