Gmail Query Syntax
provos/ironcurtain
Reference for Gmail's search query syntax — operators like is:sent, newerthan:, from:, has:attachment, label:, and how they compose.
Single entry point for email tasks in QwenPaw through qwenpawmail-mcp: read, search, send, reply, organize, and bind or register a personal mailbox.
SKILL.md written in Chinese; this summary is our English description.
$ npx skills add agentscope-ai/QwenPaw --skill mailbox -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install agentscope-ai/QwenPaw mailbox --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/agentscope-ai/QwenPaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/qwenpaw/agents/skills/mailbox-zh .claude/skills/mailbox && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "mailbox" agent skill from https://github.com/agentscope-ai/QwenPaw/tree/main/src/qwenpaw/agents/skills/mailbox-zh into .claude/skills/mailbox/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mailbox", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/agentscope-ai/QwenPaw/tree/main/src/qwenpaw/agents/skills/mailbox-zhType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add agentscope-ai/QwenPaw --skill mailbox -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install agentscope-ai/QwenPaw mailbox --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/agentscope-ai/QwenPaw.git skills-src && mkdir -p .agents/skills && cp -r skills-src/src/qwenpaw/agents/skills/mailbox-zh .agents/skills/mailbox && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "mailbox" agent skill from https://github.com/agentscope-ai/QwenPaw/tree/main/src/qwenpaw/agents/skills/mailbox-zh into .agents/skills/mailbox/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mailbox", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add agentscope-ai/QwenPaw --skill mailbox -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install agentscope-ai/QwenPaw mailbox --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/agentscope-ai/QwenPaw.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/src/qwenpaw/agents/skills/mailbox-zh .cursor/skills/mailbox && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "mailbox" agent skill from https://github.com/agentscope-ai/QwenPaw/tree/main/src/qwenpaw/agents/skills/mailbox-zh into .cursor/skills/mailbox/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mailbox", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/agentscope-ai/QwenPaw.git --path src/qwenpaw/agents/skills/mailbox-zh--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add agentscope-ai/QwenPaw --skill mailbox -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install agentscope-ai/QwenPaw mailbox --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/agentscope-ai/QwenPaw.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/src/qwenpaw/agents/skills/mailbox-zh .gemini/skills/mailbox && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "mailbox" agent skill from https://github.com/agentscope-ai/QwenPaw/tree/main/src/qwenpaw/agents/skills/mailbox-zh into .gemini/skills/mailbox/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mailbox", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install agentscope-ai/QwenPaw mailboxInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add agentscope-ai/QwenPaw --skill mailbox -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/agentscope-ai/QwenPaw.git skills-src && mkdir -p .github/skills && cp -r skills-src/src/qwenpaw/agents/skills/mailbox-zh .github/skills/mailbox && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "mailbox" agent skill from https://github.com/agentscope-ai/QwenPaw/tree/main/src/qwenpaw/agents/skills/mailbox-zh into .github/skills/mailbox/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mailbox", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add agentscope-ai/QwenPaw --skill mailbox -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install agentscope-ai/QwenPaw mailbox --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/agentscope-ai/QwenPaw.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/src/qwenpaw/agents/skills/mailbox-zh .opencode/skills/mailbox && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "mailbox" agent skill from https://github.com/agentscope-ai/QwenPaw/tree/main/src/qwenpaw/agents/skills/mailbox-zh into .opencode/skills/mailbox/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mailbox", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
mailboxSingle entry point for email tasks in QwenPaw through qwenpawmail-mcp: read, search, send, reply, organize, and bind or register a personal mailbox.
This skill is the only route for mail work in QwenPaw: viewing, reading, searching, sending, replying, forwarding, organizing and deleting messages, managing threads, and binding a personal mailbox or registering a new one. Everything goes through qwenpawmail-mcp, and the agent must not invent other mail flows or run raw IMAP or SMTP commands. It supports 9 personal domains from NetEase, Tencent, Sina, Aliyun and Gmail, but not enterprise mailboxes, custom domains or Microsoft mail.
Credentials get careful handling. The agent.json file holds only public mailbox settings, secrets such as auth_code, password and phone number are kept out of it, and the agent must never read, decrypt, print or edit credentials.yaml. For an existing account the agent calls check_auth, asks you to update credentials in QwenPaw settings if they are missing, and uses set_credentials only as a session-level override. New NetEase or Tencent addresses get guided sign-up in a visible browser where you type passwords, phone numbers and codes yourself. Aliyun accepts existing accounts only. The skill text is in Chinese.
4 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit d7a0f50. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are json).
From the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
zc.reg.163.comssl.zc.qq.commail.sina.com.cnmail.sina.cnaccounts.google.comFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
QwenPaw Mailbox Operations loads about 1.3k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 313 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from agentscope-ai/QwenPaw at commit d7a0f50, republished under its Apache-2.0 licence (© agentscope-ai). 313 words, ~1,280 tokens.
.claude/skills/mailbox/SKILL.md (or your agent's skills folder).使用 qwenpawmail-mcp 绑定或注册邮箱并执行邮件操作。
QwenPaw 托管邮箱流程当前支持以下 9 个邮箱域名:
| 服务商 | 域名 | 登录凭据 |
|---|---|---|
| 网易 | 163.com、126.com、yeah.net | 16 位授权码 |
| 腾讯 | qq.com、foxmail.com | 16 位授权码 |
| 新浪 | sina.com、sina.cn | 16 位授权码 |
| 阿里 | aliyun.com | 邮箱登录密码;仅支持已有账号 |
gmail.com | 开启两步验证后生成的 16 位应用专用密码 |
当前托管流程不支持企业邮箱、自定义域名和 Microsoft 邮箱。
create_mailbox 仅为 163.com、126.com、yeah.net、qq.com 和 foxmail.com 提供内置注册引导。其他受支持域名需走服务商官方注册流程。aliyun.com 已关闭个人邮箱新注册,只能绑定已有账号。
任何邮件操作都必须从此技能进入。不要自行编造其他邮件流程,也不要绕过 qwenpawmail-mcp 直接执行原始 IMAP/SMTP 命令。
agent.json 只保存公开邮箱配置。mail 的预期结构为:
{
"mail": {
"is_new_account": false,
"credential": {
"name": "myaccount",
"domain": "163.com",
"provider": ""
},
"push": {
"mode": "off",
"rules": [],
"poll_interval_seconds": 120,
"access_control_enabled": false
}
}
}敏感字段 auth_code、password 和 phone_number 会被刻意排除在 agent.json 之外,Agent API 响应也不会返回它们。服务商凭据统一通过 auth_code 表示,配置后会被加密保存;注册密码和手机号只在对应邮箱的注册网页内填写,当前 QwenPaw 流程不会保存。公开配置中看不到 auth_code 并不表示用户没有配置凭据。
QwenPaw 仅在运行时通过托管 DriverCard 解析加密的服务商凭据。绝不要读取、解密、打印、复制或修改 credentials.yaml,也不要在文件或日志中搜索 secret。请严格使用下述流程。
从 agent.json 读取 mail.is_new_account、mail.credential.name 和 mail.credential.domain。当前支持的个人邮箱域名对应的 provider 应为空字符串。
如果不存在 mail,请用户先在 QwenPaw 的智能体设置界面配置“邮箱管理”。
is_new_account 为 false:管理已有邮箱check_auth。托管 DriverCard 已经通过运行时凭据引用获取加密存储中的邮箱凭据;不要从 agent.json 查找凭据,也不要因为看不到 secret 字段就调用 set_credentials。check_auth 成功后,执行用户要求的邮件操作。check_auth。set_credentials 作为仅限当前会话的临时覆盖,随后调用 check_auth。它不会更新 QwenPaw 的加密配置,MCP 进程重启后即失效。临时调用 set_credentials 时,传入完整邮箱地址,并把服务商所需凭据放入名为 auth_code 的参数。对于 aliyun.com,该参数实际填写登录密码;其他受支持域名填写 16 位授权码或应用专用密码。
is_new_account 为 true:注册专属邮箱使用 agent.json 中公开的用户名和域名。如果用户名为空,让 create_mailbox 生成用户名,或先与用户确定用户名。
注册密码和手机号只在对应邮箱的注册网页内填写,Agent 无法读取。不要尝试从文件恢复它们。QwenPaw 专属邮箱表单中的可选凭据字段仅用于注册完成后的最终授权码、应用专用密码或邮箱登录密码。请选择以下路径之一:
create_mailbox(domain, username) 校验用户名并获取当前服务商引导。官方注册入口:
| 域名 | 注册入口 | 说明 |
|---|---|---|
163.com、126.com、yeah.net | https://zc.reg.163.com/regInitialized | 网易统一流程,需要手机验证 |
qq.com、foxmail.com | https://ssl.zc.qq.com/v3/index-chs.html | QQ 注册流程,需要手机验证 |
sina.com | https://mail.sina.com.cn/register/weixin.php | 微信授权注册 |
sina.cn | https://mail.sina.cn/register/regmail.php | 手机短信注册 |
gmail.com | https://accounts.google.com/signup | 注册后开启两步验证并创建应用专用密码 |
aliyun.com | 不可用 | 已关闭个人邮箱新注册,只能使用已有账号 |
只有看到明确的注册成功提示或成功进入收件箱后,才能判定注册成功。如果最终用户名与原计划不同,应报告原因和最终邮箱地址。
对于网易或腾讯域名,调用 create_mailbox(domain, username),把返回的备选用户名、注册链接和步骤告知用户。请用户在自己的浏览器中完成密码、手机号、验证码和短信验证等所有敏感步骤。
对于新浪或 Gmail,引导用户使用上方官方入口。对于 aliyun.com,说明无法注册新账号,并请用户选择其他受支持域名。
agent.json。is_new_account 设为 false、加密保存 secret、同步托管 DriverCard 并重载智能体。check_auth;验证成功前不要调用其他邮件工具。CONTACTS.md。| 工具 | 用途 |
|---|---|
list_folders | 列出所有邮箱文件夹 |
list_messages | 分页列出文件夹中的邮件元数据 |
get_message | 按文件夹和 UID 获取单封邮件 |
get_attachment | 按文件名或索引获取附件 |
search_messages | 按关键词、发件人或日期范围搜索邮件 |
check_auth | 使用当前运行时凭据重新验证 IMAP 和 SMTP 登录 |
create_mailbox | 返回网易/腾讯受支持域名的注册引导 |
list_threads | 增量同步并列出会话线程 |
search_threads | 搜索会话线程 |
get_thread | 获取一个线程中的所有邮件 |
get_mailbox_stats | 获取近期邮箱统计 |
| 工具 | 用途 |
|---|---|
send_message | 发送带 to/cc/bcc 的纯文本邮件 |
reply_message | 使用正确的线程头回复邮件 |
forward_message | 以 RFC 822 附件形式转发邮件 |
mark_messages | 标记已读/未读/星标/取消星标 |
move_message | 将邮件移动到其他文件夹 |
create_folder | 创建邮箱文件夹 |
set_credentials | 为当前 MCP 进程设置临时内存凭据 |
clear_credentials | 清除临时覆盖并回退到启动时注入的凭据 |
update_thread | 添加或移除线程自定义标签 |
| 工具 | 用途 |
|---|---|
delete_message | 永久删除单封邮件 |
delete_thread | 将整个线程移入垃圾箱 |
check_auth 验证。agent.json、DriverCard YAML、CONTACTS.md、日志或对话总结。delete_message 或 delete_thread 前必须向用户确认。list_messages 或 search_messages 刷新。check_auth。CONTACTS.md,但绝不能在其中保存凭据。© agentscope-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in src/qwenpaw/agents/skills/mailbox-zh of agentscope-ai/QwenPaw.
Open the folder on GitHubat commit d7a0f50
QwenPaw Mailbox Operations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| QwenPaw Mailbox Operations this skillagentscope-ai/QwenPaw | 36k | — | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| Gmail Query Syntaxprovos/ironcurtain | 612 | — | ~971 | Automated safety check: Pass | Apache-2.0 | |
| Email CheckAgriciDaniel/claude-email | 130 | — | ~2.4k | Automated safety check: Pass | MIT | |
| Connectorsautonomous-ai/Physical-AI-Operating-System | 381 | — | ~10k | Automated safety check: Notes | Apache-2.0 | |
| Add Gmailsbusso/claudeclaw | 194 | — | ~1.9k | Automated safety check: Pass | MIT | |
| Performance Patternss-morgan-jeffries/apple-mail-fast-mcp | 104 | — | ~1.5k | Automated safety check: Pass | MIT |
provos/ironcurtain
Reference for Gmail's search query syntax — operators like is:sent, newerthan:, from:, has:attachment, label:, and how they compose.
AgriciDaniel/claude-email
Intelligent inbox triage that connects to Gmail or Outlook, scores emails by importance (0-100) using sender recognition, urgency keywords, thread depth, time sensitivity, and business relevance…
autonomous-ai/Physical-AI-Operating-System
Discover and use linked third-party services (Gmail, Google Calendar, Google Drive, Notion, Figma, Asana, Linear, GitHub, Ahrefs, Facebook Fan Page and others).
sbusso/claudeclaw
Add Gmail integration to ClaudeClaw. An agent skill from sbusso/claudeclaw.
s-morgan-jeffries/apple-mail-fast-mcp
A skill your agent uses when optimizing Apple Mail MCP operations, diagnosing slow queries, adding new filtering logic, or modifying how data is fetched from Mail.app.
lanes-sh/app
A skill your agent uses when installing or standing up Lanes Link, the self-hostable MCP endpoint that gives an agent someone's own accounts, memory, tasks, assets, skills, identity and vault.
agentscope-ai/QwenPaw
Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.
agentscope-ai/QwenPaw
Turns reusable decisions, templates or workflows from the current conversation into a new workspace skill through plan, approval, draft, validation and publication.
agentscope-ai/QwenPaw
Creates a focused workspace skill from the current conversation in QwenPaw, moving through a planning, approval, drafting, validation and publishing script pipeline.
agentscope-ai/QwenPaw
Creates and manages scheduled or recurring jobs with the qwenpaw cron commands, always tied to an explicit agent ID and a confirmed target channel.
agentscope-ai/QwenPaw
Creates, reads and edits Word .docx files, including tracked changes and comments, using docx-js for new files and XML editing for existing ones.
agentscope-ai/QwenPaw
Connects, registers, and operates a personal mailbox, reading, searching, sending, and organizing, through a managed mail server for nine domains.
Works with
Categories
Single entry point for email tasks in QwenPaw through qwenpawmail-mcp: read, search, send, reply, organize, and bind or register a personal mailbox. This skill is the only route for mail work in QwenPaw: viewing, reading, searching, sending, replying, forwarding, organizing and deleting messages, managing threads, and binding a personal mailbox or registering a new one. Everything goes through qwenpawmail-mcp, and the agent must not invent other mail flows or run raw IMAP or SMTP commands.
QwenPaw Mailbox Operations fits situations like: reading or searching the inbox of a bound personal mailbox; sending, replying to or forwarding an email through QwenPaw; binding an existing mailbox or registering a new 163 or QQ address.
Run `npx skills add agentscope-ai/QwenPaw --skill mailbox -a claude-code`. Or copy the skill folder (src/qwenpaw/agents/skills/mailbox-zh in agentscope-ai/QwenPaw) into .claude/skills/mailbox in your project. Claude Code loads it when a task matches its description.
Run `npx skills add agentscope-ai/QwenPaw --skill mailbox -a codex`. Or copy the skill folder (src/qwenpaw/agents/skills/mailbox-zh in agentscope-ai/QwenPaw) into .agents/skills/mailbox in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agentscope-ai/QwenPaw --skill mailbox -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mailbox, .gemini/skills/mailbox, .github/skills/mailbox and .opencode/skills/mailbox in your project.
SKILL.md names no scripts, command-line tools or credentials: QwenPaw Mailbox Operations is instructions for the agent only. Our summary lists: The qwenpawmail-mcp server; A QwenPaw agent with mailbox settings in agent.json; A mailbox on a supported provider, such as 163.com, qq.com or gmail.com; A visible browser for new mailbox sign-up.
SKILL.md names 5 domains. In commands or code: zc.reg.163.com, ssl.zc.qq.com, mail.sina.com.cn, mail.sina.cn and accounts.google.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
QwenPaw Mailbox Operations is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with QwenPaw Mailbox Operations: Gmail Query Syntax (provos/ironcurtain, 612 stars), Email Check (AgriciDaniel/claude-email, 130 stars), Connectors (autonomous-ai/Physical-AI-Operating-System, 381 stars) and Add Gmail (sbusso/claudeclaw, 194 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
agentscope-ai (a GitHub organization) maintains it in agentscope-ai/QwenPaw, which has 35,521 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 9, 2026.
Source: agentscope-ai/QwenPaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.