MCP cover image
See in Github
2025-04-04

Yet Another Gmail MCP Server

1

Github Watches

0

Github Forks

0

Github Stars

yagms

Yet Another Gmail MCP Server

Setup and Usage

Gmail MCP Server

The Gmail MCP server provides tools to interact with your Gmail account through the Model Context Protocol (MCP).

Prerequisites

  1. Create OAuth credentials for Gmail API:
    • Go to Google Cloud Console
    • Create a new project or select an existing one
    • Enable the Gmail API
    • Create OAuth 2.0 credentials (Desktop application)
    • Download the credentials JSON file and save it as ~/.yagms-oauth.keys.json

Build this project

  1. Install Bun.
  2. Build the code
bun install
bun run build-gmail # It will emit ./dist/gmail.js

Authentication

Before using the Gmail MCP server, you need to authenticate with your Google account:

# Run the authentication flow
bun run dist/gmail.js auth

This will:

  • Launch a browser window for you to sign in to your Google account
  • Request permission to access your Gmail account
  • Save the authentication credentials to ~/.yagms-credentials.json

Running the Server

After authentication, you can run the Gmail MCP server:

# Run the server
bun run src/gmail.ts

Configuration

You can customize the paths for OAuth keys and credentials using environment variables:

  • GMAIL_OAUTH_PATH: Path to the OAuth keys file (default: ~/.yagms-oauth.keys.json)
  • GMAIL_CREDENTIALS_PATH: Path to save the credentials (default: ~/.yagms-credentials.json)

Available Tools

The Gmail MCP server provides the following tools:

  1. list-emails: Get emails from your inbox

    • Parameters:
      • senderEmail (optional): Filter by sender email
      • maxResults (optional, default: 10): Maximum number of emails to return
      • labelIds (optional, default: ["INBOX"]): Label IDs to filter by
  2. get-email: Get a specific email by ID

    • Parameters:
      • emailId: The ID of the email to retrieve
  3. search-emails: Search for emails using Gmail search syntax

    • Parameters:
      • query: Gmail search query (e.g., "from:example@gmail.com has:attachment")
      • maxResults (optional, default: 10): Maximum number of emails to return
  4. get-labels: Get all Gmail labels

    • No parameters required

Example MCP Configuration

Add this to your MCP settings file:

{
  "mcpServers": {
    "gmail": {
      "command": "bun",
      "args": ["run", "/path/to/yagms/dist/gmail.js"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

相关推荐

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • Lists Tailwind CSS classes in monospaced font

  • https://zenepic.net
  • Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • modelcontextprotocol
  • Model Context Protocol Servers

  • Mintplex-Labs
  • The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

  • ravitemer
  • A powerful Neovim plugin for managing MCP (Model Context Protocol) servers

  • jae-jae
  • MCP server for fetch web page content using Playwright headless browser.

  • patruff
  • Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools

  • pontusab
  • The Cursor & Windsurf community, find rules and MCPs

  • WangRongsheng
  • 🧑‍🚀 全世界最好的LLM资料总结(Agent框架、辅助编程、数据处理、模型训练、模型推理、o1 模型、MCP、小语言模型、视觉语言模型) | Summary of the world's best LLM resources.

    Reviews

    2 (1)
    Avatar
    user_7EIZnxki
    2025-04-16

    As a dedicated user of MCP applications, I highly recommend yagms by acro5piano. This product adds tremendous value and functionality, proving indispensable for projects requiring high efficiency and robust performance. Check it out at https://github.com/acro5piano/yagms and you won't be disappointed!