Self-hosted IntentMail MCP server for Gmail and Outlook OAuth, delta sync, AI-assisted review, local rules, and bounded provider actions. Runs locally over stdio; cloud AI features send selected message content to the configured provider.
IntentMail has 45 tools with basic naming (verb_noun pattern mostly followed) but critical gaps in descriptions and schemas. Most tool descriptions are 20-80 chars (below the 194-char baseline for A+ tools). Parameter descriptions are sparse or missing entirely. Input schemas are present but lack depth, many parameters have no type constraints, enums, or validation guidance. No output schemas documented. Error handling is absent from descriptions. The server attempts comprehensive email functionality but lacks the LLM-optimization rigor required for production agent use.
Health check tool
Execute a bounded action on emails
Run custom analytics queries on email data
Get analytics summary of email data
Apply a label to one or more emails
Apply a rule to selected emails
Get statistics about attachments in emails
Complete OAuth authentication flow and store credentials
Descriptions are uniformly short (40-60 chars) and lack LLM-optimization guidance. Most lack WHEN to use, prerequisites, or recovery hints. Baseline for A+ tools is 194 chars.
No output schemas documented. LLMs cannot plan downstream tool calls or extract required fields (e.g., does mail_search return thread_id for mail_get_thread?). Breaks tool composition.
Parameter descriptions missing or trivial for many tools. E.g., mail_create_rule accepts 'conditions' and 'actions' arrays with no schema, format, or examples. LLMs cannot construct valid payloads.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Start OAuth authentication flow for Gmail or Outlook
Permanently delete staged emails
Get AI suggestions for composing an email
Create a new email automation rule
Generate a daily digest of important emails
Delete an automation rule
Get log of deleted emails
Generate an email draft using AI
Export email data to Parquet format
Extract and process attachments from emails
Find duplicate emails in the mailbox
Flag or unflag emails
Download and retrieve an attachment from a message
Get audit log of rule executions and changes
Get a complete email thread with all messages
List all configured email accounts
List attachments in a message
List available email contexts for AI operations
List all folders/labels in an account
List all labels/folders in an account
List all automation rules
List emails staged for deletion
Move emails to a different folder/label
Parse a Gmail-style search query into structured format
Rollback rule executions to a previous state
Search emails using Gmail-style query syntax
Search emails using semantic/AI-powered search
Send an email message
Stage emails for deletion (soft delete)
Summarize an email or thread using AI
Sync emails from configured accounts with delta sync support
Get sync statistics and metrics
AI-powered email triage and priority classification
Remove emails from deletion staging
Start watching for new emails with push notifications
Get status of email watch
Stop watching for new emails
No enum constraints on string parameters. mail_auth_start accepts 'provider' as free-form string instead of enum ['gmail', 'outlook']. Invites hallucinated values.
Destructive tools (mail_commit_deletions, mail_delete_rule) lack confirmation/dry-run patterns and error recovery guidance. No mention of rollback or undo in descriptions.