mail-summary-tracker
An MCP server that connects to Gmail and delivers AI-readable email summaries grouped by category — Promotions, Work, Finance, Social, Updates, and more — with tools to get counts, unread overviews, and filtered email lists by date range.
How to pay
Subscribe
$10/month
Predictable monthly cost with included usage. Best for steady, high-volume traffic.
- Unlimited tools within plan limits
- One API key, billed once a month
- Cancel any time
Gmail Category Summary MCP Server Overview A TypeScript-based Model Context Protocol (MCP) server that integrates with the Gmail API to bring structured, category-aware email intelligence directly into AI assistants like Claude. Instead of manually digging through a cluttered inbox, simply ask:
"Summarize my emails from last week" "How many promotional emails did I get this month?"
And get clean, organized answers instantly.
Authentication Authenticates securely via Gmail OAuth2, with all credentials managed through environment variables — keeping setup secure and portable across machines.
Tools ToolDescriptiongmail_summary_by_categoryFetches and groups emails by category within a date rangegmail_category_countsReturns a fast email count per category — a quick inbox snapshotgmail_emails_in_categoryDrills into a specific category with full sender, subject, date & snippetgmail_unread_summarySurfaces top unread items per category so nothing slips through
Categories Emails are automatically sorted into 7 smart buckets:
📢 Promotions — newsletters, discounts, marketing 👥 Social — LinkedIn, Twitter, Facebook notifications 💰 Finance — bank alerts, invoices, payment receipts 💼 Work — work domain emails and professional keywords 🔔 Updates — app notifications, shipping, subscriptions 🚫 Spam / Junk — low-priority or suspicious emails 📥 Primary — personal and important emails
Detection uses Gmail's native labels, sender domain pattern matching, and subject line keyword analysis.
Compatibility Runs over stdio transport — plug-and-play with:
Claude Desktop n8n MCP nodes Any MCP-compatible client
Error Handling Every tool returns actionable error messages for:
Expired OAuth tokens → prompts re-authentication API rate limits → suggests retry timing Empty results → friendly "No emails found" message