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.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
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.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 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.