广告合作
MCP.so
登录

yagms MCP Server

@acro5piano

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

acro5piano

关于 yagms MCP Server

Yet Another Gmail MCP Server

#gmail#mcp#server

yagms MCP Server 配置

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

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

yagms MCP Server 工具

3

`senderEmail` (optional): Filter by sender email

`emailId`: The ID of the email to retrieve

`query`: Gmail search query (e.g., "from:example@gmail.com 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:example@gmail.com 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

常见问题

1

What dependencies does yagms require?

yagms requires [Bun](https://bun.sh) to build and run, and a Google Cloud project with the Gmail API enabled and OAuth 2.0 credentials.

2

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`.

3

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.

4

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.

5

What are the available tools?

yagms provides four tools: `list-emails`, `get-email`, `search-emails`, and `get-labels`. Each has documented parameters as shown in the README.

评论

其他 分类下的更多 MCP 服务器

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

der die das – German noun genders (Lingviko)

Lingviko

The article (der, die, das) of 90,000 German nouns, compounds included, plus a checker that finds wrong articles in German text (“mit der Zug” → dem). Uses dictionary data, not AI guessing. Free, no login.

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K
广告合作