Alibaba Mail Admin (unofficial)

● Active

io.github.mfcompliance/alimail-admin-mcp

Manage Alibaba Mail (阿里邮箱) users, departments, groups and contacts via the admin OpenAPI

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "alimail-admin-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mfcompliance/alimail-admin-mcp@0.2.1"
      ],
      "env": {
        "ALIMAIL_CLIENT_ID": "<your ALIMAIL_CLIENT_ID>",
        "ALIMAIL_CLIENT_SECRET": "<your ALIMAIL_CLIENT_SECRET>",
        "ALIMAIL_READ_ONLY": "true",
        "ALIMAIL_API_BASE": "https://alimail-cn.aliyuncs.com"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env ALIMAIL_CLIENT_ID='<your ALIMAIL_CLIENT_ID>' --env ALIMAIL_CLIENT_SECRET='<your ALIMAIL_CLIENT_SECRET>' --env ALIMAIL_READ_ONLY=true --env ALIMAIL_API_BASE=https://alimail-cn.aliyuncs.com --transport stdio alimail-admin-mcp -- npx -y @mfcompliance/alimail-admin-mcp@0.2.1
OpenAI Codex CLI
codex mcp add alimail-admin-mcp --env ALIMAIL_CLIENT_ID='<your ALIMAIL_CLIENT_ID>' --env ALIMAIL_CLIENT_SECRET='<your ALIMAIL_CLIENT_SECRET>' --env ALIMAIL_READ_ONLY=true --env ALIMAIL_API_BASE=https://alimail-cn.aliyuncs.com -- npx -y @mfcompliance/alimail-admin-mcp@0.2.1
VS Code
code --add-mcp '{"name":"alimail-admin-mcp","type":"stdio","command":"npx","args":["-y","@mfcompliance/alimail-admin-mcp@0.2.1"],"env":{"ALIMAIL_CLIENT_ID":"<your ALIMAIL_CLIENT_ID>","ALIMAIL_CLIENT_SECRET":"<your ALIMAIL_CLIENT_SECRET>","ALIMAIL_READ_ONLY":"true","ALIMAIL_API_BASE":"https://alimail-cn.aliyuncs.com"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • ALIMAIL_CLIENT_IDrequiredAlibaba Mail OpenAPI application client ID
  • ALIMAIL_CLIENT_SECRETrequiredsecretAlibaba Mail OpenAPI application client secret
  • ALIMAIL_READ_ONLYSet to false to register write and destructive tools
  • ALIMAIL_API_BASEAPI endpoint of your Alibaba Mail cluster

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
E-commerce & Retail
Version
0.2.1
Registry
active
Published
11/18/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 19, 2026

Looks healthy: Alibaba Mail Admin (unofficial) is maintained, open source.

Maintained
Active
Last commit 4 days ago (Nov 18, 2026), 0 open issues.
Official registry
Active
Published as io.github.mfcompliance/alimail-admin-mcp in the official MCP registry, version 0.2.1.
Source
Open source, MIT
Public repository under the MIT licence, 1 stars, 0 forks.
Runs
On your machine
A local npm package started by your client; it can reach whatever your user account can.
Credentials
2 required
Declared environment variables: ALIMAIL_CLIENT_ID, ALIMAIL_CLIENT_SECRET. They stay on your machine; the config on this page shows where each goes.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 18, 2026
Stars
1
Forks
0
Last push
Nov 18, 2026
License
MIT

TypeScript

From the README

alimail-admin-mcp 基于阿里邮箱开放平台 API 的 MCP(Model Context Protocol)服务。在 Claude、VS Code Copilot、Cursor 等 AI 客户端里,用自然语言管理企业邮箱的用户、部门、邮件组、公共通讯录、组织与域名,以及收信黑白名单、隔离区和审计日志。 ⚠️ 本项目为非官方实现,与阿里云 / 阿里邮箱无隶属关系。它使用的应用凭证具有企业邮箱管理员级别的权限,请在充分理解风险后使用,并阅读免责声明。 特性 • 66 个工具,分为 8 个工具集: • users:账号增删改查、别名、重置密码、邮箱设置、共享成员、安全手机、撤销登录态 • departments:部门增删改查、层级链,以及可递归获取整棵部门树的组合工具 • groups:邮件组增删改查与成员管理 • contacts:公共联系人及分组管理,可递归获取分组树 • org:组织信息、域名的添加 / 验证 / 删除 • security:域级收信黑白名单、隔离区邮件的搜索 / 查看 / 放行 / 删除 • audit:审计日志查询 • login:生成免登录链接(默认不启用) • 默认只读:ALIMAILREADONLY=true 时只注册 30 个查询工具 • 破坏性操作需两步确认:先返回预览和一次性 confirmToken,确认后才执行 • 域名范围限制:ALIMAILALLOWEDDOMAINS 可限定只能操作指定域名下的账号 • 审计日志:所有写操作都记录为 JSON 行,密码、token 等敏感字段自动脱敏 • 稳健的 API 客户端:token 缓存并提前刷新;令牌桶限流;429/5xx 自动退避重试,非幂等写操作不盲目重试;错误统一格式化并附带修复提示 • 两种传输方式:stdio(默认)与 Streamable HTTP(--http) • Resources:alimail://departments/tree、alimail://users/{email};Prompts:onboardemployee(入职)、offboardemployee(离职) 准备工作:创建阿里邮箱应用 1. 以管理员身份登录阿里邮箱域管后台,进入 高级应用 → API 开放平台(或“应用管理”),创建应用。 2. 按最小权限原则授予 API 权限:只给启用的工具集授权(用户、部门、邮件组、公共联系人、组织与域名、收信规则、隔离区、审计日志、免登等)。只读场景只授读权限;需要写操作再授读写权限。权限名称以后台实际列出的为准。 3. 记录应用的 clientid 与 clientsecret。 4.…

Read the full README on GitHub →

The most-starred E-commerce & Retail servers in the index, with their live-check result.

ServerStarsLast pushLive check
eBay Seller Tools202Nov 2026Local / not checked
handle-mcp162Nov 2026Local / not checked
Secondhand MCP103Oct 2026Local / not checked
MCP Cn Commerce102Nov 2026Local / not checked
Alza MCP102Nov 2026Local / not checked

Alibaba Mail Admin (unofficial): questions people ask

Is Alibaba Mail Admin (unofficial) a remote or a local MCP server?
According to its entry in the official MCP registry, Alibaba Mail Admin (unofficial) ships as a local package (npm) that your client starts on your machine.
Does Alibaba Mail Admin (unofficial) need an API key?
Its registry entry declares 2 required environment variables: ALIMAIL_CLIENT_ID, ALIMAIL_CLIENT_SECRET. The config on this page shows where each goes.
Is Alibaba Mail Admin (unofficial) safe to use?
Looks healthy: Alibaba Mail Admin (unofficial) is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: 2 required. Serverdex check of Nov 19, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Alibaba Mail Admin (unofficial) still maintained?
Active: the repository's last commit 4 days ago. Last push Nov 18, 2026, 1 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
How do I add Alibaba Mail Admin (unofficial) to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all E-commerce & Retail →

Add the badge to your site

Show visitors that Alibaba Mail Admin (unofficial) is listed here — it’s also the link we check for a free listing.

Alibaba Mail Admin (unofficial) — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-mfcompliance-alimail-admin-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Alibaba Mail Admin (unofficial) — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Alibaba Mail Admin (unofficial) — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-mfcompliance-alimail-admin-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-mfcompliance-alimail-admin-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-mfcompliance-alimail-admin-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-mfcompliance-alimail-admin-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-mfcompliance-alimail-admin-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-mfcompliance-alimail-admin-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-mfcompliance-alimail-admin-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).