Skip to main content
Glama
jhongjun1981

EmailAssistant MCP Server

by jhongjun1981
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

EmailAssistant MCP Server

AI-powered email assistant. Send, parse, and manage emails using natural language. MCP server with 4 tools (smart_email, parse_email_intent, send_email, email_chat). Supports SSE/stdio transport and Bearer Token authentication.

EmailAssistant - AI 邮件助手

用自然语言发邮件的智能助手。支持 GUI、API、MCP Server 三种使用方式。

功能

  • 自然语言发邮件 — "帮我给 test@qq.com 发个会议通知" 一句话搞定

  • 多模型意图解析 — 智谱 GLM / DeepSeek / 通义千问 / Claude / 本地规则

  • 附件支持 — 自动识别文件路径并附加

  • MCP Server — 可被 Claude Code / Claude Desktop 等 AI 工具直接调用

Related MCP server: Mailbridge MCP

快速开始

方式一：Windows 本机安装

# 1. 一键安装
双击 install.bat

# 2. 编辑配置（填入 LLM API Key）
编辑 config.json

# 3. 一键启动（API + GUI）
双击 start_all.bat

方式二：Docker

# 1. 准备配置
cp config.example.json config.json
# 编辑 config.json 填入 API Key

# 2. 启动
docker-compose up -d

# 3. 如需 MCP SSE 模式
docker-compose --profile mcp-sse up -d

前置依赖

  • Python 3.10+（Windows 安装）

  • EmailMarketer 服务运行在 localhost:8100（用于实际发送邮件）

配置说明

编辑 config.json：

字段

说明

model

当前使用的模型：zhipu / deepseek / qwen / claude / local

models.*.api_key

对应模型的 API Key

emailmarketer.api_url

EmailMarketer API 地址（默认 http://localhost:8100）

emailmarketer.api_key

EmailMarketer API Key

不想配 API Key？选择 local 模式，使用本地规则解析（无需联网）。

API 接口

启动：python run_api.py（端口 8200）

方法

路径

说明

GET

/api/v1/health

健康检查

POST

/api/v1/parse

意图解析（{"message": "..."} → 结构化 JSON）

POST

/api/v1/send

直接发邮件（to_email, subject, body, attachment_path）

POST

/api/v1/chat

一步到位：解析 → 发邮件或聊天回复

MCP Server 集成

Claude Code

在项目根目录 .mcp.json 中添加：

{
  "mcpServers": {
    "email-assistant": {
      "command": "python",
      "args": ["<路径>/EmailAssistant/run_mcp.py"],
      "cwd": "<路径>/EmailAssistant",
      "env": {
        "EA_API_URL": "http://localhost:8200"
      }
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中添加相同配置。

MCP Tools

Tool

说明

smart_email(message)

自然语言发邮件

parse_email_intent(message)

仅解析意图，不发送

send_email(to_email, subject, body, attachment_path)

直接发邮件

email_chat(message)

智能聊天

SSE 模式

python run_mcp.py --transport sse --port 8201

端口分配

服务

端口

API

8200

MCP SSE

8201

项目结构

EmailAssistant/
├── main.py              # GUI 主程序
├── intent_parser.py     # 意图解析引擎
├── email_client.py      # EmailMarketer API 客户端
├── config_manager.py    # 配置管理
├── config.json          # 运行配置
├── config.example.json  # 配置模板
├── run_api.py           # FastAPI 服务
├── run_mcp.py           # MCP Server
├── requirements.txt     # Python 依赖
├── install.bat          # Windows 一键安装
├── start_all.bat        # Windows 一键启动
├── Dockerfile           # Docker 镜像
└── docker-compose.yml   # Docker 编排

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • IMAP Email MCP Server

    jdickey1
    A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to read, search, compose, and send emails by connecting to any IMAP/SMTP provider. It supports comprehensive mailbox management, including draft handling and message deletion, directly through natural language.
    10
    209 npm
    10
    MIT

  • Mailbridge MCP

    Creativestefan
    A
    license
    Not graded
    quality
    D
    maintenance
    Connects AI assistants to email accounts via IMAP/SMTP, enabling reading, searching, sending, and organizing emails with features like smart drafts, scheduling, and attachment handling.
    82 npm
    2
    MIT

  • mcp-imap

    andrewmalov
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to interact with email accounts via IMAP and SMTP, supporting mailbox listing, email search, retrieval, sending, and management.
    MIT

  • Mail MCP Server

    martinzarfl
    A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to send, read, and manage emails via SMTP and IMAP, with support for attachments, threads, and mailbox organization.
    16
    6 npm
    1
    MIT