Gmail

Gmail MCP是一个实现了Model Context Protocol (MCP)标准的Gmail API接口服务，提供标准化的电子邮件管理功能。

通信工具开发者工具 #邮件管理 #API接口 #Gmail集成 #OAuth认证远程 .TypeScript

评分 : 2.5分

下载量 : 7.4K

更新时间 : 2025-04-28

打开站点

什么是Gmail MCP?

Gmail MCP是一个标准化的工具，通过Model Context Protocol (MCP)实现对Gmail API的访问，使用户能够轻松地管理、发送和检索电子邮件。

如何使用Gmail MCP?

首先需要安装并配置Gmail MCP，然后使用OAuth认证登录。配置完成后，您可以开始使用提供的API来操作您的邮箱。

适用场景

适合需要批量管理邮件、自动化邮件处理以及快速集成邮件功能的应用场景。

主要功能

邮件管理

支持列出、获取、修改和删除邮件。

草稿管理

创建、更新、发送和删除草稿。

标签管理

添加、更新、删除和自定义邮件标签。

会话管理

操作邮件会话（如移动到垃圾箱或恢复）。

设置管理

管理自动转发、IMAP/POP设置、假期回复等。

优势

支持全面的Gmail API功能。

易于集成到现有系统中。

提供安全的OAuth2认证机制。

局限性

初次配置需要一定的技术知识。

依赖于Google云平台的支持。

如何使用

安装Gmail MCP

通过npm安装Gmail MCP客户端。

配置认证

下载并配置Google Cloud的OAuth凭证。

开始使用

利用提供的API调用进行邮件管理。

使用案例

批量发送邮件

通过脚本批量发送多封邮件。

设置自动回复

启用假期自动回复功能。

常见问题

如何获取OAuth凭证？

是否支持多账户登录？

🚀 Gmail MCP 使用说明

Gmail MCP 是一个实现了模型上下文协议（MCP）的 npm 包，主要用于与 Gmail API 进行交互。它提供了标准化接口，能帮助开发者更便捷地管理、发送和检索电子邮件。

🚀 快速开始

初始化配置文件

根据不同的操作系统，将配置文件放置在相应的目录：

Mac/Linux：~/.config/gmail-mcp/config.json
Windows：%APPDATA%/gmail-mcp/config.json

示例配置文件内容如下：

{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "refreshToken": "your_refresh_token"
}

初始化 Gmail 客户端

在代码里初始化客户端时，要指定配置文件的路径与默认的收件箱：

import { GmailClient } from '@shinzolabs/gmail-mcp';

// 初始化 Gmail 客户端，默认使用 development 环境模式
const gmail = new GmailClient({
  configFile: process.env.NODE_ENV === 'development' ? '~/.config/gmail-mcp/config.json' : undefined,
  defaultInbox: 'INBOX'
});

// 连接 Gmail 服务
await gmail.connect();

✨ 主要特性

实现模型上下文协议（MCP），与 Gmail API 交互。
提供标准化接口，方便管理、发送和检索电子邮件。

📦 安装指南

可使用 npm 或 yarn 进行安装：

npm install @shinzolabs/gmail-mcp
# 或者
yarn add @shinzolabs/gmail-mcp

💻 使用示例

基础用法

import { GmailClient } from '@shinzolabs/gmail-mcp';

// 初始化 Gmail 客户端，默认使用 development 环境模式
const gmail = new GmailClient({
  configFile: process.env.NODE_ENV === 'development' ? '~/.config/gmail-mcp/config.json' : undefined,
  defaultInbox: 'INBOX'
});

// 连接 Gmail 服务
await gmail.connect();