Yagms MCP Server

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

Local serverstdioGo

What is the Yagms MCP Server?

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

Configuration and credentials

  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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
Parameters:query: Gmail search query (e.g., "from:example@gmail.com has:attachment")
maxResultsoptional, default: 10): Maximum number of emails to return
labelIdsoptional, default: ["INBOX"]): Label IDs to filter by

How to install the Yagms MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  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

Example prompts to try

  • “Use Yagms to Parameters.”
  • “Use Yagms to Prerequisites.”
  • “Use Yagms to Authentication.”

Frequently asked questions

The Gmail MCP server provides tools to interact with your Gmail account through the Model Context Protocol (MCP). Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.