Skip to main content
Glama
wuenhouse

Tencent Mail Agent MCP Server

by wuenhouse

Tencent Mail Agent MCP Server

這是一個基於 Model Context Protocol (MCP) 的伺服器,提供從 騰訊企業郵 (Tencent Exmail) 或任何支援 IMAP 協定的郵件服務中獲取並分析郵件的工具。此伺服器旨在與 Claude Desktop 等 MCP 客戶端配合使用。

功能特點

  • list_yesterday_emails: 獲取昨天的郵件。

    • 自動依據日期範圍過濾(SINCE 昨天, BEFORE 今天)。

    • 回傳的 metadata 包含:UID、寄件者 (From)、主旨 (Subject)、日期 (Date) 以及內文片段 (snippet,前 500 個字元)。

    • 效能優化:預設限制獲取最新的 100 封郵件(可設定)。

Related MCP server: IMAP/SMTP Email MCP Server

前置需求

  • Node.js (建議 v18 或更高版本)

  • npm

  • 騰訊企業郵帳號或任何 IMAP 帳號。

安裝步驟

  1. 複製專案庫:

    git clone <repository-url>
    cd mail-agent-mcp
  2. 安裝依賴套件:

    npm install
  3. 編譯專案:

    npm run build

設定方法

  1. .env.example 複製並重新命名為 .env

    cp .env.example .env
  2. 編輯 .env 並提供您的郵件登入資訊:

    EMAIL_USER=your-email@example.com
    EMAIL_PASSWORD=your-app-password
    EMAIL_HOST=imap.exmail.qq.com
    EMAIL_PORT=993
    NOTE

    對於騰訊企業郵,如果您啟用了兩階段驗證 (2FA),則需要使用應用專用密碼 (App Password)

使用方法

開發模式 (Development Mode)

npm run dev

正式模式 (Production Mode)

npm start

整合至 Claude Desktop

若要將此伺服器加入 Claude Desktop,請在您的 claude_desktop_config.json 中新增以下設定:

{
  "mcpServers": {
    "mail-agent": {
      "command": "node",
      "args": ["/絕對路徑/至/mail-agent-mcp/dist/index.js"],
      "env": {
        "EMAIL_USER": "your-email@example.com",
        "EMAIL_PASSWORD": "your-app-password",
        "EMAIL_HOST": "imap.exmail.qq.com",
        "EMAIL_PORT": "993"
      }
    }
  }
}

授權條款 (License)

ISC

Available Tools

1 tool
list_yesterday_emailsA

Fetch emails received yesterday. Limited to the latest 100 emails to ensure performance.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum number of emails to fetch (default: 100)

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It discloses a limit of 100 emails and mentions performance as a rationale, which is useful. However, it does not state whether the operation is read-only, how results are ordered, or what fields are returned, leaving notable behavioral aspects undisclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two concise sentences, front-loaded with the core purpose and a brief performance rationale. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with one optional parameter and no siblings, but the description omits important context such as timezone handling for 'yesterday', result ordering, and what email data is included. It is adequate but leaves several gaps that could affect correct usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already documents the limit parameter. The description adds 'Limited to the latest 100 emails' but this conflicts with the schema's configurable limit parameter, potentially misleading the agent into thinking the limit is fixed at 100. This adds negative value rather than clarifying parameter semantics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool fetches emails received yesterday, with a specific verb ('Fetch') and resource ('emails received yesterday'). It is unambiguous and distinguishes this tool from potential siblings by specifying the time scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies the tool is for retrieving yesterday's emails but does not explicitly state when to use it versus alternatives, nor any exclusions. With no sibling tools provided, the lack of explicit guidance is less critical, but still a gap.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool updatev1.0.0
    • First observedlist_yesterday_emails

TDQS

A3.6/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap. The tool's purpose is singular and clear.

Naming Consistency5/5

The single tool name 'list_yesterday_emails' follows a clear verb_noun pattern and is descriptive. Consistency is trivially maintained.

Tool Count3/5

One tool feels thin for a mail server, but it is not entirely trivial—it does one specific task. The count is borderline and could be part of a larger intended set.

Completeness1/5

The server appears to be for email management, yet it only lists yesterday's emails. Missing send, read, search, and other lifecycle operations represent severe gaps for the domain.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Enables users to connect to their email inbox via IMAP to search, filter, and summarize emails based on criteria like subject, date, and sender. Supports marking emails as read and provides customizable email summarization with various prompt options.
    2
    73
    ISC
  • F
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to read recent emails and fetch full email content from an IMAP inbox, allowing natural language queries about email summaries.
    3
    -
  • 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

Latest Blog Posts

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/wuenhouse/mail-mcp'

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