mcpField
G
gmcli

gmcli

github.com/badlogic生产力2.6k157 次安装21 周前更新
代码仓库

关于 gmcli

gmcli 是用于执行 Gmail 操作的命令行工具。配置 OAuth 账户后，可搜索邮件、阅读会话线程、发送邮件，以及管理标签和草稿。

主要功能

  1. 01使用 Gmail 查询语法搜索邮件
  2. 02阅读线程中的全部邮件
  3. 03发送邮件
  4. 04列出标签和草稿
  5. 05配置 OAuth 账户

适用场景

  1. 01搜索邮件
  2. 02查看完整邮件线程
  3. 03通过命令行发送邮件
  4. 04查看标签或草稿

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/badlogic/pi-skills --skill gmcli

安装后在 Claude Code 中输入/gmcli确认已加载。

详细介绍

Gmail CLI

用于执行 Gmail 操作的命令行界面。

安装

npm install -g @mariozechner/gmcli

设置

Google Cloud Console（一次性设置）
  1. 创建新项目（或选择现有项目）
  2. 启用 Gmail API
  3. 在 OAuth 品牌设置中设置应用名称
  4. 添加测试用户（所有要使用的 Gmail 地址）
  5. 创建 OAuth 客户端：
    • 点击“Create Client”
    • 应用类型：“Desktop app”
    • 下载 JSON 文件
配置 gmcli

首先检查是否已完成配置：

gmcli accounts list

如果没有账号，请引导用户完成设置：

  1. 询问他们是否已有启用 Gmail API 的 Google Cloud 项目
  2. 如果没有，引导他们完成上述 Google Cloud Console 步骤
  3. 让他们下载 OAuth 凭据 JSON 文件
  4. 运行：gmcli accounts credentials ~/path/to/credentials.json
  5. 运行：gmcli accounts add <email>（在无浏览器的环境中进行 OAuth 时使用 --manual）

使用方法

运行 gmcli --help 查看完整命令参考。

常见操作：

  • gmcli <email> search "<query>" - 使用 Gmail 查询语法搜索邮件
  • gmcli <email> thread <threadId> - 阅读包含所有邮件的邮件会话
  • gmcli <email> send --to <emails> --subject <s> --body <b> - 发送邮件
  • gmcli <email> labels list - 列出所有标签
  • gmcli <email> drafts list - 列出草稿

数据存储

  • ~/.gmcli/credentials.json - OAuth 客户端凭据
  • ~/.gmcli/accounts.json - 账号令牌
  • ~/.gmcli/attachments/ - 已下载的附件

评论

支持 Markdown