yagms

Name: yagms
Author: acro5piano

@acro5piano

代码仓库

关于 yagms

Yet Another Gmail MCP Server

#gmail #mcp #server

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

acro5piano

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "yagms": {
      "command": "bun",
      "args": [
        "run",
        "build-gmail",
        "#",
        "It",
        "will",
        "emit",
        "./dist/gmail.js"
      ]
    }
  }
}

工具

`senderEmail` (optional): Filter by sender email

`emailId`: The ID of the email to retrieve

`query`: Gmail search query (e.g., "from:[email protected] has:attachment")

概览

What is yagms?

yagms is a Gmail MCP server that provides tools to interact with your Gmail account through the Model Context Protocol (MCP). It is built with Bun and allows AI assistants to read, search, and manage Gmail data.

How to use yagms?

First, create OAuth credentials in Google Cloud Console and save them as ~/.yagms-oauth.keys.json. Then build the project with bun install and bun run build-gmail. Run bun run dist/gmail.js auth to authenticate, then start the server with bun run src/gmail.ts. Configure MCP to point to the built dist/gmail.js file.

Key features of yagms

List emails with optional sender, max results, and label filters
Retrieve a specific email by its ID
Search emails using Gmail search syntax (e.g., from:[email protected] has:attachment)
Get all Gmail labels from your account
Customizable OAuth and credentials file paths via environment variables

Use cases of yagms

Automatically fetch recent emails from a specific sender
Summarize the content of an important email by its ID
Search for emails with attachments or from a particular domain
Retrieve all Gmail labels for organization or filtering purposes
Integrate email reading capabilities into an AI assistant workflow

FAQ from yagms

What dependencies does yagms require?

yagms requires Bun to build and run, and a Google Cloud project with the Gmail API enabled and OAuth 2.0 credentials.

How do I authenticate with my Gmail account?

Run bun run dist/gmail.js auth which opens a browser for Google sign-in and saves credentials to ~/.yagms-credentials.json. You can customize the paths with GMAIL_OAUTH_PATH and GMAIL_CREDENTIALS_PATH.

Where are authentication files stored?

OAuth keys default to ~/.yagms-oauth.keys.json and credentials default to ~/.yagms-credentials.json. Both paths are configurable via environment variables.

Does yagms support any transport besides stdio?

The README only shows a command-line MCP configuration using bun runtime; it does not mention HTTP or other transports. The server is designed for local stdio-based MCP communication.