广告合作
MCP.so
登录

Gmail MCP Server

@shinzo-labs

代码仓库

基本信息

分类

沟通协作

许可证

MIT

传输方式

stdio

作者

shinzo-labs

提交者

Austin Born

关于 Gmail MCP Server

MCP Implementation for Gmail Services

#gmail#email-management#api-integration

Gmail MCP Server 配置

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

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@shinzolabs/gmail-mcp"
      ]
    }
  }
}

Gmail MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

What is Gmail?

A Model Context Protocol (MCP) server implementation for the Gmail API, providing a standardized interface for email management, sending, and retrieval. It enables AI agents and MCP-compatible clients to interact with Gmail programmatically through a unified set of tools.

How to use Gmail?

After setting up a Google Cloud project and enabling the Gmail API, users run npx @shinzolabs/gmail-mcp auth to obtain an OAuth refresh token. The server can then be installed locally via npx or by building from source, or used as a remote server through Smithery CLI. Configuration variables such as CLIENT_ID, CLIENT_SECRET, and REFRESH_TOKEN are set in the MCP client's config file.

Key features of Gmail

  • Complete coverage of the Gmail API (messages, threads, labels, drafts, settings)
  • Send, draft, and manage emails with full message manipulation
  • Label management with customizable colors and visibility
  • Thread operations for conversation-based management
  • Settings management (vacation responder, IMAP/POP, language, filters)
  • History tracking for mailbox changes
  • Secure OAuth2 authentication using Google Cloud credentials

Use cases of Gmail

  • Automate email sending and drafting from within an AI assistant
  • Manage labels and threads to organize a Gmail inbox programmatically
  • Configure vacation responders or IMAP/POP settings without manual clicks
  • Integrate with building an AI-powered email client or chatbot

常见问题

1

What are the prerequisites for using this server?

You need Node.js 18+, a Google Cloud project with the Gmail API enabled, and an OAuth 2.0 Client ID (Desktop app type). Each user must run the `auth` command to generate a refresh token.

2

How do I obtain a Gmail OAuth refresh token?

After setting up the Google API client once per organization, each user copies the OAuth keys file to `~/.gmail-mcp/gcp-oauth.keys.json` and runs `npx @shinzolabs/gmail-mcp auth`. A browser window opens to approve scopes, and the refresh token is saved.

3

Is telemetry collected, and can I opt out?

Yes, limited anonymous telemetry is collected by default to improve the product. No personally identifiable information is included. You can disable telemetry by setting the environment variable `TELEMETRY_ENABLED=false`.

4

Where are credentials and configuration files stored?

By default, the Google API client keys are stored at `~/.gmail-mcp/gcp-oauth.keys.json` and user credentials at `~/.gmail-mcp/credentials.json`. You can override these paths using `GMAIL_OAUTH_PATH` and `GMAIL_CREDENTIALS_PATH`.

5

Can I run this server remotely (e.g., on Smithery)?

Yes. Use the Smithery CLI (`npx -y @smithery/cli install @shinzo-labs/gmail-mcp`) and provide your `CLIENT_ID`, `CLIENT_SECRET`, and `REFRESH_TOKEN` when prompted. The server will be hosted remotely and accessible to your MCP client.

评论

沟通协作 分类下的更多 MCP 服务器

Agent Inbox

Agent Inbox

Give your agent an inbox. Its own address on email, Slack and Telegram. A product of Novu

Mobile Text Alerts SMS

Mobile Text Alerts

Official Mobile Text Alerts server. Send and schedule SMS, manage subscribers and groups, and complete carrier registration from any MCP-compatible AI assistant.

SomaCheck Vibecheck

Sensie-agents

Body language for AI agents, on your terms. A consented three-second phone gesture gives your agent an Aligned or Unaligned signal with confidence. You remain the authority.

1

Soprano Connect MCP Server

soprano-mcp

Soprano Connect MCP Server enables you to build AI agents that can communicate, engage customers, and manage communications workflows through the Soprano Connect platform using the Model Context Protocol (MCP).

R

RelayLink

RelayLink lets your AI assistant send briefings to other people's AI assistants. Draft a package from your current conversation, attach files, approve the note, and the recipient's AI gets the full context: decisions, op

广告合作