Skip to main content
Glama
pp123ys

email-mcp-server

by pp123ys
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
EMAIL_USERNAMENoEmail account username
EMAIL_AUTH_MODENoAuthentication mode, e.g., app_password
EMAIL_IMAP_HOSTNoIMAP server host, e.g., imap.example.com
EMAIL_IMAP_PORTNoIMAP server port, e.g., 993
EMAIL_SMTP_HOSTNoSMTP server host, e.g., smtp.example.com
EMAIL_SMTP_PORTNoSMTP server port, e.g., 465
EMAIL_HTTP_TOKENNoOptional HTTP token for HTTP mode (currently only warns, not enforced)
EMAIL_AUTH_SECRETNoAuthentication secret or app password
EMAIL_SENT_FOLDERNoFolder name for sent emails, e.g., [Gmail]/Sent Mail

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_inboxB

分页列出邮件，支持未读/发件人/文件夹过滤

read_emailA

读取单封邮件完整内容（纯文本正文 + 附件元信息）；email_id 格式为 folder:uid，如 INBOX:1

get_threadA

拉取整条会话线程；email_id 格式为 folder:uid，如 INBOX:1

search_emailsA

关键词/发件人/日期范围搜索；结果仅含元数据（主题/发件人/收件人/日期/ID），正文为空，按服务器顺序返回未排序；需要读取正文请用 read_email

list_foldersA

列出所有文件夹

get_attachmentsA

列出某邮件的附件元信息；email_id 格式为 folder:uid，如 INBOX:1

download_attachmentA

按 part_id 下载附件，返回 base64 内容；email_id 格式为 folder:uid，如 INBOX:1

get_email_headersA

读取原始 RFC 822 邮件头；email_id 格式为 folder:uid，如 INBOX:1

get_account_infoB

返回当前账号身份信息

send_emailA

直接发送邮件（立即投递）；to 不能为空，cc 可选；如需人工确认请改用 save_draft 存草稿后手动发送

save_draftA

存草稿到 Drafts 文件夹（人工确认后手动发送）；to 可为空（先起草后补收件人），cc 可选

list_draftsA

列出草稿

reply_emailB

回复邮件：自动生成引用块并填收件人；email_id 格式为 folder:uid，如 INBOX:1

forward_emailB

转发邮件：自动生成引用块；email_id 格式为 folder:uid，如 INBOX:1

mark_readB

标记已读；email_id 格式为 folder:uid，如 INBOX:1

mark_unreadB

标记未读；email_id 格式为 folder:uid，如 INBOX:1

archiveA

归档（移入 All Mail）；email_id 格式为 folder:uid，如 INBOX:1

move_emailB

移动到指定文件夹；email_id 格式为 folder:uid，如 INBOX:1

trash_emailA

移入废纸篓（软删除）；email_id 格式为 folder:uid，如 INBOX:1

set_flagB

设置邮件标记（默认星标 \Flagged）；email_id 格式为 folder:uid，如 INBOX:1

pin_emailA

置顶/星标邮件；email_id 格式为 folder:uid，如 INBOX:1

snooze_emailA

延后提醒（until 为 ISO 时间，到期重新标记未读）；email_id 格式为 folder:uid，如 INBOX:1

unsubscribeA

基于 List-Unsubscribe 头自动退订（仅 mailto 方式）；email_id 格式为 folder:uid，如 INBOX:1

schedule_sendB

定时发送（send_at 为 ISO 时间，服务器进程存活期间到期执行）；to 不能为空

batch_sendA

同模板批量发送（每批最多 20 封，受发送频率限制）；to 不能为空，空 to 拒绝

create_labelC

创建标签（IMAP 映射为文件夹）

manage_labelsA

标签管理：action=list 列出，action=delete 删除（需 name）

get_account_statusA

查看邮箱配置状态：configured 布尔、缺失字段列表、已配置账号信息（不含密钥）

configure_accountA

配置邮箱账号（IMAP/SMTP 凭据）。首次运行或配置缺失时调用；auth_secret 为敏感信息，请先征得用户同意再写入；写入后立即生效并持久化到 .env

test_email_connectionA

用当前配置试连 IMAP 与 SMTP（仅登录验证，不发送邮件），返回逐项结果

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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/pp123ys/email-mcp-server'

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