yagms

yagms

site icon
2025.04.04 0
JavaScriptGmail交互邮件管理交流协作
yagms(Yet Another Gmail MCP Server)是一个基于Model Context Protocol (MCP)的Gmail交互服务,允许用户通过MCP协议与Gmail账户进行交互。它提供了多种工具来管理电子邮件,包括列出邮件、获取特定邮件、搜索邮件和获取标签等功能。
View on GitHub

Overview

基本能力

产品定位

yagms是一个Gmail交互服务,通过MCP协议提供对Gmail账户的访问和管理功能。

核心功能

  • list-emails: 列出收件箱中的邮件,支持按发件人、最大结果数和标签ID过滤。
  • get-email: 根据邮件ID获取特定邮件。
  • search-emails: 使用Gmail搜索语法搜索邮件。
  • get-labels: 获取所有Gmail标签。

适用场景

  • 自动化邮件管理
  • 批量处理邮件
  • 邮件搜索和过滤

工具列表

  1. list-emails: 列出邮件,支持过滤和分页。
  2. get-email: 获取特定邮件内容。
  3. search-emails: 使用高级搜索语法查找邮件。
  4. get-labels: 获取所有邮件标签。

常见问题解答

  • 如何获取OAuth凭证? 访问Google Cloud Console,创建项目并启用Gmail API,生成OAuth 2.0凭证。
  • 如何运行服务器? 使用bun run src/gmail.ts命令启动服务器。

使用教程

使用依赖

  1. 安装Bun。
  2. 创建OAuth凭证并保存为~/.yagms-oauth.keys.json

安装教程

bun install
bun run build-gmail

调试方式

bun run dist/gmail.js auth
bun run src/gmail.ts

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。