IntentMail
Intent Solutions is a Claude Partner Network Select Services Partner.
Multi-surface email platform with MCP server, Discord bot, and web dashboard. AI-powered email management with team collaboration features.
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
Intent Solutions is a Claude Partner Network Select Services Partner.
Multi-surface email platform with MCP server, Discord bot, and web dashboard. AI-powered email management with team collaboration features.
Multi-surface email platform: MCP server (47 tools), Discord bot, and web dashboard. AI drafts, semantic search, inbox triage, and team collaboration for Gmail/Outlook.
A complete email management platform:
email-checkin,
email-triage-actions, and email-project-context skills (see below)v0.5.1
Implemented:
Not done:
IntentMail ships as a self-hosted Claude Code plugin: you hold the OAuth token, and the database and full-text index stay on your machine. Requested AI triage, summaries, and drafts send selected message content to your configured cloud AI provider; choose local Ollama when content must remain local.
git clone https://github.com/jeremylongshore/intent-mail
cd intent-mail
npm ci --omit=dev && npm run build # build dist/ (the MCP server entry)
The plugin manifest is .claude-plugin/plugin.json; it wires the local
intentmail MCP server over stdio (node bin/intentmail.js serve), so its
tools resolve as mcp__intentmail__mail_*. It bundles three skills:
Set INTENTMAIL_MASTER_KEY (see .env.example) so token encryption is keyed
explicitly in production. Configure an account with mail_auth_start and an AI
provider key, then ask Claude to "check my inbox".
node --version # v20 or higher
npm --version # v10 or higher
git clone https://github.com/jeremylongshore/intent-mail.git
cd intent-mail
npm install
Create OAuth credentials:
http://localhost:3000/oauth/callbackConfigure environment:
cp .env.example .env
# Edit .env and add your credentials:
# .env
GMAIL_CLIENT_ID=your-client-id.apps.googleusercontent.com
GMAIL_CLIENT_SECRET=your-client-secret
GMAIL_REDIRECT_URI=http://localhost:3000/oauth/callback
Set up OAuth consent screen (required by Google):
IntentMail Dev# Build TypeScript
npm run build
# Start MCP server
npm start
You should see:
Database initialized at ./data/intentmail.db
intentmail-mcp-server v0.5.1 started successfully
Listening on stdio...
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"intentmail": {
"command": "node",
"args": ["<absolute-path-to-intent-mail>/dist/index.js"]
}
}
}
Replace <absolute-path-to-intent-mail> with the full path where you cloned the repository (e.g., /Users/you/projects/intent-mail on macOS, /home/you/intent-mail on Linux).
Restart Claude Desktop, then try:
Use the health_check tool
In Claude Desktop:
Use mail_auth_start with provider: gmail
Click the URL, authorize, and you're ready!
health_check - Server status and capabilitiesmail_auth_start / mail_auth_complete - OAuth flow (Gmail/Outlook)mail_list_accounts - List connected accountsmail_sync / mail_sync_stats - Delta sync + statisticsmail_search / mail_semantic_search / mail_parse_query - Searchmail_get_thread - Thread with all messagesmail_send - Send mail; mail_draft / mail_compose_suggest generate textmail_daily_digest - Structured daily-review payload (stats, priority groups, why)mail_triage - Per-email P1–P4 priority + action + why + deadlinemail_summarize - Long-thread / message summariesmail_list_contexts - List @project:/@client: context handles (context injection)mail_action - Consolidated op: mark_read / archive / flag / move / stage_delete / unsubscribemail_flag - Flag / unflag (Outlook flag, Gmail STARRED)mail_move - Move to folder (Outlook) / relabel (Gmail)mail_list_folders - Folders (Outlook) / labels (Gmail)mail_list_labels - Provider labels/folders; mail_apply_label changes local cached labelsmail_list_attachments / mail_get_attachment / mail_extract_attachments / mail_attachment_statsmail_stage_delete / mail_list_staged / mail_unstage / mail_commit_deletions / mail_deletion_log / mail_find_duplicatesmail_commit_deletions removes local database rows only. It does not delete
messages from Gmail or Outlook.
mail_list_rules / mail_create_rule / mail_delete_rule / mail_apply_rulemail_get_audit_log / mail_rollbackmail_watch_start / mail_watch_stop / mail_watch_status (Gmail push; Outlook delta-poll)mail_analytics_summary / mail_analytics_query / mail_export_parquet┌──────────────────────────────────────────┐
│ Claude Code / AI Assistant │
└────────────────┬─────────────────────────┘
│ MCP Protocol (stdio)
┌────────────────▼─────────────────────────┐
│ IntentMail MCP Server (Node.js) │
│ ┌────────────────────────────────────┐ │
│ │ 47 MCP Tools │ │
│ │ (search, send, rules, rollback) │ │
│ └──────────────┬─────────────────────┘ │
│ │ │
│ ┌──────────────▼─────────────────────┐ │
│ │ Rules Engine + Audit Log │ │
│ │ (dry-run, plan, rollback) │ │
│ └──────────────┬─────────────────────┘ │
│ │ │
│ ┌──────────────▼─────────────────────┐ │
│ │ SQLite Storage + FTS5 Search │ │
│ │ (local database, full-text index) │ │
│ └──────────────┬─────────────────────┘ │
└──────────────────┼───────────────────────┘
│
┌────────────┴────────────┐
│ │
┌─────▼──────┐ ┌───────▼────────┐
│ Gmail API │ │ Outlook Graph │
│ (History) │ │ (Delta sync) │
└────────────┘ └────────────────┘
historyId tracking/delta endpoint with deltaToken// Create a rule
mail_create_rule({
name: "Archive Newsletters",
conditions: [
{ field: "from", operator: "contains", value: "newsletter" }
],
actions: [
{ type: "archive" }
]
})
// Test it first (dry-run)
mail_apply_rule({ ruleId: 1, dryRun: true })
// Shows: "Would archive 15 emails"
// Apply it
mail_apply_rule({ ruleId: 1, dryRun: false })
// Changed your mind?
mail_rollback({ ruleId: 1 })
// Restores all emails to previous state
All actions logged with before/after states:
{
"ruleId": 1,
"emailId": 42,
"stateBefore": { "labels": ["INBOX"], "flags": [] },
"stateAfter": { "labels": ["ARCHIVED"], "flags": ["SEEN"] },
"executedAt": "2025-12-24T10:00:00Z"
}
./data/intentmail.db)npm test # Run all tests
npm run typecheck # TypeScript strict mode check
sqlite3 ./data/intentmail.db
> .tables
> SELECT * FROM accounts;
> SELECT COUNT(*) FROM emails;
# Automatic mode (opens browser)
node test-oauth-auto.js
# Manual mode (paste code)
node test-oauth.js
bd list # List all tasks
bd show <id> # Show task details
bd update <id> --status in_progress
Quick start:
docker-compose up -d
For distribution: See Docker Guide for:
This is a self-hosted, stdio MCP — you run it yourself; there is no cloud deploy pipeline.
npm ci && npm run build, then intentmail serve (or wire it into
your Claude Code / Claude Desktop config — see "Use as a Claude Code plugin").OAuth 2.0 only. No passwords stored.
Security features:
Requirements:
.env filesReport vulnerabilities: Security Policy
Current (Phase 3):
Next (Phase 4):
Later (Phase 5):
Q: Does this replace Gmail/Outlook? No - IntentMail is a layer on top. You keep using Gmail/Outlook normally. IntentMail just gives AI access to automate things.
Q: What happens if I use Gmail while IntentMail is running? Everything stays in sync. Gmail is the source of truth. Changes you make in Gmail web/mobile show up in IntentMail, and vice versa.
Q: Can I undo actions?
Yes! Every rule execution is logged with before/after states. Use mail_rollback to restore emails to their previous state.
Q: Is my email data safe? Email is stored locally in SQLite (not in the cloud). OAuth tokens are encrypted. Code is open source for review.
Q: Does this work with personal Gmail accounts? Yes - works with both personal Gmail and Google Workspace accounts.
We welcome contributions! See Contributing Guide for:
intent-mail/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── mcp/tools/ # 47 MCP tool implementations
│ ├── connectors/ # Gmail, Outlook, IMAP
│ ├── rules/ # Rules engine + parser
│ ├── storage/ # SQLite + migrations
│ └── types/ # TypeScript interfaces
├── .github/workflows/ # CI (lint/test/build), security, release
├── test-oauth-auto.js # OAuth testing scripts
└── data/ # SQLite database (gitignored)
Apache-2.0 — see LICENSE.
000-docs/bd list)Stack: TypeScript, Node.js 20, SQLite, MCP SDK, Gmail API, Microsoft Graph
Status: Alpha. Breaking changes expected.
Multi-surface email platform: MCP server (47 tools), Discord bot, and web dashboard. AI drafts, semantic search, inbox triage, and team collaboration for Gmail/Outlook.
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Intent Mail stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। Multi-surface email platform: MCP server (47 tools), Discord bot, and web dashboard. AI drafts, semantic search, inbox triage, and team collaboration for Gmail/Outlook.