de en es ja ko ru zh

Mailbunker_MCP

Name: Mailbunker_MCP
Author: cubetribe

by cubetribe

Overview Schema Related Servers Score Discussions

Python

Local

🔒 Mailbunker_MCP

零信任加密邮件归档、实时 IMAP 推送摄取（IDLE）、Obsidian 保险库生成器，以及模型上下文协议（MCP）服务器。

License: MIT Python 3.10+ MCP Ready Security: Zero--Trust SQLite FTS5

English • Deutsch

📖 关于 Mailbunker

Mailbunker_MCP 是一款开源、隐私至上的电子邮件归档与语义搜索堡垒，旨在彻底解决邮件混乱、供应商锁定和检索难题。

它可连接任意数量的 IMAP 电子邮件账户（工作、个人、iCloud、Gmail、Posteo、Hetzner、Mailbox.org、自定义服务器），通过 IMAP IDLE Push 实时摄取新邮件，使用由主密码经 Argon2id 派生的 零信任 AES-256-GCM 加密 保护所有数据，为所有邮件建立索引以支持 亚毫秒级全文搜索（SQLite FTS5），并为 Claude Desktop、Cursor 和自主 AI 智能体提供标准 模型上下文协议（MCP） 工具。

Related MCP server: mailpouch

✨ 功能

⚡ 实时推送摄取（IMAP IDLE）：
- 邮件到达你的服务商后立即实现零延迟捕获（RFC 2177）。无需延迟的 cron 轮询。
- 弹性自动保活刷新和指数退避自动重连。
🛡️ 零信任静态加密：
- 所有邮件正文（Markdown 和 HTML）、原始头信息和二进制附件（PDF、图片、文档）均使用 AES-256-GCM 加密。
- 通过高内存开销的 Argon2id（VAULT_PASSWORD）派生主密钥，可高度抵抗 GPU/ASIC 暴力破解攻击。
- 磁盘或 Docker 卷上零明文泄漏。
🔍 亚毫秒级全文搜索（SQLite FTS5）：
- 在毫秒内搜索超过 100,000 封邮件。
- 支持布尔运算符（AND、OR、NOT）、前缀匹配（tax*）、短语搜索（"contract agreement"）以及结构化筛选（按发件人、日期范围、账户、文件夹、附件有无）。
- 生成带有匹配高亮的丰富上下文摘要。
📓 面向 Obsidian 的 Markdown 保险库：
- 将复杂 HTML 邮件转换为简洁的 GitHub Flavored Markdown。
- 完整的 YAML frontmatter 元数据（id、subject、from、to、date、account、folder、tags、attachments）。
- 用于邮件线程跟踪的原生 Obsidian wikilink（[[Parent Note]]）。
- 按需导出（mailbunker export-vault）或配置实时自动导出。
🤖 模型上下文协议（MCP）服务器：
- 原生 FastMCP 服务器，提供高层工具：search_emails、get_email、list_accounts、list_mailboxes、sync_now、get_sync_status、export_obsidian_vault。
- 无缝集成 Claude Desktop、Cursor IDE、Antigravity 以及任何兼容 MCP 的 AI 助手。
🔑 多账户与 macOS 钥匙串集成：
- 通过 .env（MAIL_1_... 到 MAIL_5_...）轻松设置 1 到 5+ 个电子邮件账户。
- 交互式 macOS 钥匙串发现助手（mailbunker keychain-import）。

🏗️ 架构

graph TD
    subgraph Email_Sources [Email Sources]
        A1[Account 1: IMAP IDLE Push]
        A2[Account 2: IMAP IDLE Push]
        A3[Account 3..N: .env / Config]
        KC[macOS Keychain Helper]
    end

    subgraph Mailbunker_Core [Mailbunker Core Engine]
        SM[Sync & IDLE Manager]
        MP[MIME & HTML to Markdown Parser]
        CE[Zero-Trust Crypto Engine: AES-256-GCM + Argon2id]
        FTS[SQLite Database + FTS5 Search Index]
        OV[Obsidian Vault Generator]
    end

    subgraph Interfaces [Interfaces & Consumers]
        MCP[MCP Server: FastMCP Tools & Resources]
        CLI[Rich CLI: start, sync, search, get, export]
        OBS[Decrypted Obsidian Vault]
        AI[AI Assistants / Claude / Cursor]
    end

    A1 --> SM
    A2 --> SM
    A3 --> SM
    KC -.-> A3
    SM --> MP
    MP --> CE
    CE --> FTS
    CE --> OV
    FTS --> MCP
    FTS --> CLI
    OV --> OBS
    MCP --> AI
    CLI --> OBS

🚀 快速开始

1. 安装

# Clone the repository
git clone https://github.com/cubetribe/Mailbunker_MCP.git
cd Mailbunker_MCP

# Create virtual environment and install dependencies
uv venv
source .venv/bin/activate
uv pip install -e .

2. 配置（`.env`）

复制提供的 .env.example 模板：

cp .env.example .env

使用你的设置编辑 .env：

# ==============================================================================
# Zero-Trust Master Password (REQUIRED)
# ==============================================================================
VAULT_PASSWORD=your-super-secure-master-password-here

# Base storage path for encrypted database and attachments
STORAGE_PATH=./data

# ==============================================================================
# Email Accounts (Configure Mail 1 through 5, or more)
# ==============================================================================
MAIL_1_ENABLED=true
MAIL_1_NAME=Work
MAIL_1_HOST=imap.example.com
MAIL_1_PORT=993
MAIL_1_USER=user@example.com
MAIL_1_PASSWORD=your_app_specific_password
MAIL_1_SSL=true
MAIL_1_FOLDERS=INBOX,Sent

MAIL_2_ENABLED=false
MAIL_2_NAME=Personal
MAIL_2_HOST=imap.posteo.de
MAIL_2_PORT=993
MAIL_2_USER=personal@posteo.de
MAIL_2_PASSWORD=your_password
MAIL_2_SSL=true
MAIL_2_FOLDERS=INBOX

💻 CLI 命令

Mailbunker 附带一个现代化、彩色终端 CLI：

Command	Description
`mailbunker start`	为所有活动账户启动带有 IMAP IDLE 推送监听器的后台守护进程。
`mailbunker sync`	对所有已配置邮箱执行一次立即同步。
`mailbunker search "<query>"`	使用全文搜索（FTS5）搜索已索引的邮件并显示匹配结果。
`mailbunker get <id>`	解密并在终端中渲染完整邮件及其格式化 Markdown。
`mailbunker status`	显示统计信息：邮件总数、附件数、存储大小和加密状态。
`mailbunker export-vault -o <dir>`	解密并将所有邮件和附件导出到有序的 Obsidian 保险库中。
`mailbunker keychain-import`	扫描 macOS 钥匙串中已保存的邮件服务器凭据。
`mailbunker mcp`	通过 stdio 运行模型上下文协议（MCP）服务器。

CLI 示例

# Sync all accounts immediately
mailbunker sync

# Search for 2026 invoices
mailbunker search "invoice 2026"

# Check bunker health and statistics
mailbunker status

# Decrypt and export into an Obsidian Vault folder
mailbunker export-vault --output ~/Documents/Obsidian/MailVault

🤖 MCP 集成（Claude Desktop / Cursor / Antigravity）

将 Mailbunker 添加到你的 MCP 配置文件中（例如 claude_desktop_config.json 或 Cursor 设置）：

{
  "mcpServers": {
    "mailbunker": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/Mailbunker_MCP",
        "run",
        "mailbunker-mcp"
      ],
      "env": {
        "VAULT_PASSWORD": "your-super-secure-master-password-here",
        "STORAGE_PATH": "/path/to/Mailbunker_MCP/data"
      }
    }
  }
}

可用的 MCP 工具

search_emails(query, account, folder, start_date, end_date, limit)：快速 FTS5 邮件搜索。
get_email(email_id, format='markdown'|'json'|'text')：检索完整的解密消息。
list_accounts()：列出已配置的账户、状态和计数。
list_mailboxes(account_name)：列出可用的邮箱文件夹。
sync_now(account, folder)：触发立即邮箱同步。
get_sync_status()：检查实时推送监听器状态和数据库统计信息。
export_obsidian_vault(target_path, password)：解密并导出保险库。

🔒 零信任安全架构

[ Master Password: VAULT_PASSWORD ]
                 │
                 ▼ Argon2id KDF (16-byte Salt, 64MB RAM, 3 Iterations)
        [ 256-bit AES-GCM Key ]
                 │
  ┌──────────────┴──────────────┐
  ▼                             ▼
[ Email Payloads ]       [ Attachment Files ]
(Body, Headers, JSON)    (PDFs, Office Docs, Images)
  │                             │
  ▼ AES-256-GCM (IV + Tag)      ▼ AES-256-GCM (IV + Tag)
[ Encrypted SQLite DB ]  [ data/attachments/... ]

零明文泄漏：任何邮件正文、原始头信息或二进制附件都不会以未加密形式存储在磁盘上。
认证加密：AES-256-GCM 验证标签确保数据完整性并检测篡改。
Argon2id 密钥派生：高内存成本参数可抵御离线 GPU/ASIC 密码破解。

🐳 Docker 部署

在隔离的 Docker 容器中运行 Mailbunker：

docker compose up -d

🧪 测试

Mailbunker 包含全面的测试套件：

source .venv/bin/activate
pytest -v

📄 许可证

This server cannot be installed

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

io.github.p-w-4-z/inbox-mcp
Email Communication
p-w-4-z
A
license
A
quality
D
maintenance
Provider-agnostic email MCP server that connects any IMAP mailbox to AI assistants, enabling email management through natural language.
Updated 11 days ago (2026-08-10 07:55 UTC)
8
AGPL 3.0
mailpouch
Email Communication Security
chandshy
A
license
A
quality
A
maintenance
An MCP server that gives AI agents permission-gated, audit-logged access to private email providers (Proton Mail via Bridge and plain IMAP), running locally with OAuth-based authentication and human-controlled escalation for destructive operations.
Updated 10 days ago (2026-08-10 22:35 UTC)
66
525
9
MIT
MailMesh MCP
Email Communication
culpen90
F
license
Not graded
quality
B
maintenance
A private, single-user MCP server that unifies Gmail, Microsoft 365/Outlook, and IMAP mailboxes for LLMs to search and read emails live, without storing or caching mailbox contents.
Updated 7 days ago (2026-08-14 15:24 UTC)
MailOKF MCP
Email Knowledge & Memory Search
pat229988
A
license
C
quality
B
maintenance
A local-first Python MCP server that turns Gmail, Outlook/Microsoft 365, iCloud Mail, and generic IMAP/SMTP mailboxes into a synchronized, searchable OKF knowledge layer, exposing 38 tools and four resources for mailbox actions, synchronization, retrieval, attachments, and optional semantic search while keeping the provider mailbox authoritative.
Updated 17 days ago (2026-08-03 16:58 UTC)
38
MIT

View all related MCP servers

Related MCP Connectors

CryptoAgentMail
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
shipmail-mcp
Shipmail MCP server for AI agent custom-domain email inboxes with REST API and webhooks.
LLMemory
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cubetribe/Mailbunker_MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server