QQ Mail Reader MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | Yes | Host to bind the server to, e.g. 0.0.0.0 | |
| PORT | Yes | Port to listen on, e.g. 8787 | |
| OAUTH_DB_PATH | Yes | Path to the OAuth store JSON file, e.g. /data/oauth-store.json | |
| PUBLIC_BASE_URL | Yes | The public base URL of the server, e.g. https://your-domain.example | |
| MCP_ENCRYPTION_KEY | Yes | 32 random bytes in base64 used for encryption |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| qq_mail_profileA | 返回当前 OAuth 连接对应的 QQ 邮箱身份，帮助区分多个邮箱连接。不返回授权码。 |
| qq_mail_connection_statusA | 检查当前连接是否已配置，只返回邮箱地址和配置状态，绝不返回授权码。 |
| qq_mail_list_unreadA | 以只读方式列出 QQ 邮箱的未读邮件摘要，不会将邮件标记为已读。返回 mailbox 和 uid，可用于读取指定邮件。 |
| qq_mail_searchA | 按关键词、发件人、主题、日期或未读状态搜索当前已授权的 QQ 邮件，不改变邮件状态。 |
| qq_mail_readA | 使用列表或搜索结果中的 mailbox 和 uid 读取一封邮件的正文与附件元数据，不会下载附件或标记为已读。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Most tools have distinct purposes (read, list unread, search, profile, connection status), but qq_mail_profile and qq_mail_connection_status both essentially report identity/connection info and could be confused, and qq_mail_list_unread overlaps with qq_mail_search which also filters by unread state.
All tools share the consistent qq_mail_ prefix, but suffixes mix verb styles (read, list_unread, search) with noun phrases (profile, connection_status), a minor deviation from a pure verb_noun pattern.
Five tools is a well-scoped set for a focused read-only mail reader, with each tool earning its place without redundancy bloat.
As a read-only reader the core read/list/search flows are covered, but there is no way to list mailboxes/folders or list all (read) mail beyond unread, leaving notable gaps in the browse surface.