AgentHubAgentHub

emperor-mail MCP Setup & Guide

MCP ServerMCP RegistryOfficial

io.github.yarenty/emperor-mail · v0.1.3

Email over IMAP and SMTP: search and read messages and attachments; draft and send when switched on

Copy the install config on this page first, then verify docs and permissions upstream.

Overview

Email over IMAP and SMTP: search and read messages and attachments; draft and send when switched on emperor-mail is a MCP Server listed from MCP Registry. Transports: stdio. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.

Use cases

AgentHub Verified AvailabilityTested & Ready

Automated pipeline validated install commands, protocol & client compatibility

Verified At2026-11-07
Install Snippets TestedCLI & JSON config syntax verified
Protocol Handshake ReadyComplies with JSON-RPC 2.0 specifications
Origin Registry ActiveSourced from official-mcp-registry
Verified ClientsClaude Code、Claude Desktop、Cursor 等
Security Tier: A+ 级 · 官方认证推荐 (A+)·Maintained by official/verified teams, audited for standard MCP protocol compliance.
No auto-generated install guide — see the source repository README.

Troubleshooting & Common ErrorsFAQ

Common connection errors and verified fixes for emperor-mail

Getting 'connection closed' or exit code 1 in Cursor / Claude Code for emperor-mail?

Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.

Fix Snippet
# Check binary path in terminal:
which npx
node -v
Getting 'spawn npx ENOENT' or 'command not found'?

The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).

Missing required environment variable or authentication failure?

emperor-mail requires environment variables (MAIL_USER、IMAP_HOST). Ensure you have added valid keys under the 'env' object in your config file without trailing whitespace.

Fix Snippet
// .cursor/mcp.json 或 claude_desktop_config.json
{
  "env": {
    "MAIL_USER": "your_actual_key_here"
  }
}

Tool Mock Playground

Sandbox

emperor-mail Tool Interface Simulation · Preview tool schema & outputs without local runtime

Sandbox Ready
fn: emperor_mailExecute the core tool interface of emperor-mail
Request ArgumentsJSON Schema
{
  "target": "emperor-mail",
  "action": "execute",
  "options": {
    "mode": "standard",
    "timeoutMs": 5000
  }
}
💡Parameters generated dynamically by Agent runtime
Agent Tool Output

Click 'Run Mock' above

to preview the raw response returned to the LLM

Env: AgentHub Virtual SandboxJSON-RPC 2.0

Decision Guide: Why & When to Use

Assess suitability before installing to save trial-and-error time

Best Suited For
  • PR review
  • Changelog generation
  • Cross-repo issue search
When NOT to Use
  • Replacing human security audit
  • Unauthorized repo access
Recommended Workflow Pairing:View Scenario →

emperor-mail + Scenario Prompt → Complete Agent Automation

MCP hands-on: install to visible results

Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.

Open tutorial →

Related resources

Often paired with

Tencent COS

v1.2.3

SkillClawHub26710.8k

io.clawhub.shawnminh/tencent-cos-skill

腾讯云对象存储(COS)和数据万象(CI)集成技能。覆盖文件存储管理、AI处理和知识库三大核心场景。 存储场景:上传文件到云端、下载云端文件、批量管理存储桶文件、获取文件签名链接分享、查看文件元信息、查询数据万象及子服务开通状态。 图片处理场景:图片质量评估打分、AI超分辨率放大、AI智能裁剪、二维码/条形码识别、添加文字水印、获取图片EXIF信息、缩放、裁剪、旋转、格式转换。 文档处理场景:Word/Excel/PPT等办公文档转PDF、文档预览。 媒体处理场景:视频智能封面提取、视频转码、视频截帧、获取媒体信息。 内容审核场景:图片/视频/音频/文本/文档内容审核,检测违规内容。 智能语音

source

中文公文写作

v2.0.51

SkillClawHub7210.9k

io.clawhub.gongyu0918-debug/chinese-official-writing

用于中文公文、事务性材料和新闻稿件的起草、改写、压缩、润色、审校、文种核对、去口语化、降 AI 味及 Word 格式处理,适用于机关、企事业单位、学校和新闻机构。涵盖申请、请示、报告、通知、通告、意见、决定、决议、议案、公报、命令、函、复函、批复、说明、方案、纪要、公告、公示、通报、制度、规定、办法、细则、操作规程、工作要点、总结、调研、讲话、致辞、主持词、述职、可研、审查材料、技术需求、新闻消息、编者按、新闻评论,以及采购、整改、反馈和 AI 算力等场景。

source

得到大脑(原 Get 笔记)

v2.4.0

SkillClawHub76731.7k

io.clawhub.iswalle/getnote

通过官方 getnote CLI 连接得到大脑,完成浏览器授权、连接诊断、CLI 升级,以及保存、查询、搜索和管理真实笔记。用户要按录音台或录音卡来源找笔记、保存链接/图片、上传文件到知识库、查询文件限制、读取标记/发芽报告/时间线、整理知识库/文件夹、订阅博主、管理标签,或明确要求登录、诊断或升级时使用;不会自行安装或更新 Skill。

source

Keep exploring AgentHub

Most people compare similar tools or check scenario guides before installing—start here.

Listing badge: put AgentHub on your site

Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.

PreviewListed on AgentHub: emperor-mail
HTML
<a href="https://myagenthub.cn/p/io.github.yarenty/emperor-mail" title="Listed on AgentHub: emperor-mail" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.github.yarenty/emperor-mail?lang=en" alt="Listed on AgentHub: emperor-mail" height="20" style="border:0"/>
</a>
Markdown (GitHub README)
[![Listed on AgentHub: emperor-mail](https://myagenthub.cn/badge/io.github.yarenty/emperor-mail?lang=en)](https://myagenthub.cn/p/io.github.yarenty/emperor-mail)

Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.

Unified Manifest

{
  "id": "io.github.yarenty/emperor-mail",
  "type": "mcp-server",
  "version": "0.1.3",
  "displayName": "emperor-mail",
  "description": "Email over IMAP and SMTP: search and read messages and attachments; draft and send when switched on",
  "repository": {
    "url": "https://github.com/yarenty/emperor-mail",
    "source": "github"
  },
  "homepage": "https://github.com/yarenty/emperor-mail",
  "distribution": {
    "packages": [
      {
        "registryType": "binary",
        "identifier": "emperor-mail",
        "version": "0.1.3",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "MAIL_USER",
            "description": "Login name for IMAP and SMTP",
            "isRequired": true
          },
          {
            "name": "MAIL_PASSWORD",
            "description": "Password or app password (set this or MAIL_OAUTH_TOKEN)",
            "isSecret": true
          },
          {
            "name": "MAIL_OAUTH_TOKEN",
            "description": "OAuth 2.0 access token for XOAUTH2, instead of a password (Gmail, Microsoft 365)",
            "isSecret": true
          },
          {
            "name": "MAIL_FROM",
            "description": "From address when the login name is not an address (default: the login name)"
          },
          {
            "name": "IMAP_HOST",
            "description": "IMAP server host name",
            "isRequired": true
          },
          {
            "name": "IMAP_PORT",
            "description": "IMAP port (default 993, or 143 with starttls)"
          },
          {
            "name": "IMAP_SECURITY",
            "description": "IMAP connection security; plain only for a loopback host (default tls, starttls on port 143)"
          },
          {
            "name": "SMTP_HOST",
            "description": "SMTP server host name, needed only for send"
          },
          {
            "name": "SMTP_PORT",
            "description": "SMTP port (default 465, or 587 with starttls)"
          },
          {
            "name": "SMTP_SECURITY",
            "description": "SMTP connection security; plain only for a loopback host (default tls, starttls on ports 587 and 25)"
          },
          {
            "name": "MAIL_WRITABLE",
            "description": "true offers the draft tool; unset, empty, false, 0, no or off keep the server read-only"
          },
          {
            "name": "MAIL_ALLOW_SEND",
            "description": "true offers the send tool and draft; unset, empty, false, 0, no or off keep send out of the tool list"
          },
          {
            "name": "MAIL_SEND_ALLOW",
            "description": "Comma-separated recipients send may write to: addresses (ann@example.org) or domains (@example.org). With sending on and none set, every recipient is refused"
          },
          {
            "name": "MAIL_FROM_ALLOW",
            "description": "Comma-separated From addresses send and draft may use: addresses or domains (@example.org). Unset: any"
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.yarenty/emperor-mail",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.yarenty%2Femperor-mail/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
emperor-mail MCP Setup & Guide - AgentHub