Skip to main content
Glama
deenesjakoruzh
Steph-ux

gmail-mcp

by Steph-ux
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

gmail-mcp v1.0.0

Gmail向けの統合マルチアカウントGoogle OAuth2 MCPサーバー。 複数のGoogleアカウントをまたいで、メールの検索、閲覧、作成、送信、下書き、整理をシームレスに行えます。

機能（統合ツール4種）

  • gmail_search: 公式のGmail検索構文でメールを検索（is:unread、from:boss@corp.com、subject:invoice、newer_than:2d、has:attachment）

  • gmail_read: メールの本文とメタデータ（件名、送信者、テキスト本文、HTML、CC、BCC、ラベル、添付ファイル一覧）を閲覧

  • gmail_send: メールの送信または下書き作成（HTML、CC、BCC、スレッド返信、ファイル添付に対応）

  • gmail_manage: ラベル付け、アーカイブ、ゴミ箱管理、既読/未読の切り替え、完全削除、マルチアカウントの一覧表示

Related MCP server: Moist

マルチアカウント構成

単一のGoogle Cloud OAuthクライアント（credentials.json）で複数のGmailアカウントを認証できます。 トークンはアカウントごとに~/.secrets/gmail/tokens/<account_name>.jsonに保存されます。

1. Google OAuth認証情報の設定（初回のみ）

  1. Google Cloud Consoleでプロジェクトを作成する。

  2. Gmail APIを有効にする。

  3. OAuth 2.0 クライアントID（デスクトップアプリケーション）を作成する。

  4. クライアントシークレットのJSONファイルをダウンロードし、~/.secrets/gmail/credentials.jsonとして保存する（またはGMAIL_CREDENTIALS_JSONを設定する）。

2. アカウントの認証

各アカウントで対話式の認証CLIを実行します：

gmail-auth default    # Authenticates primary account
gmail-auth work       # Authenticates secondary work account
gmail-auth client_x   # Authenticates any additional account

認証済みの全アカウントを一覧表示：

gmail-auth --list

MCPクライアントへのインストール（Claude Desktop、OpenCode、Cursor、Windsurf）

オプション1: uvxによる即時導入（推奨）

{
  "mcpServers": {
    "gmail": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Steph-ux/gmail-mcp.git", "gmail-mcp"]
    }
  }
}

オプション2: pip installによる導入

pip install git+https://github.com/Steph-ux/gmail-mcp.git

その後、MCP設定ファイルに以下を追加：

{
  "mcpServers": {
    "gmail": {
      "command": "gmail-mcp"
    }
  }
}

オプション3: ローカルクローン（開発用）

{
  "mcpServers": {
    "gmail": {
      "command": "python",
      "args": ["D:\\Steph\\script\\gmail-mcp\\server.py"]
    }
  }
}

使用例

1. メールの検索

# Search in default account:
gmail_search(query='is:unread from:github')

# Search in work account:
gmail_search(account='work', query='subject:invoice newer_than:7d')

2. メールの閲覧

gmail_read(account='work', message_id='18f2a9b4c10d')

3. メールの送信または下書き作成

# Send direct email:
gmail_send(
    account='default',
    to='colleague@example.com',
    subject='Project Update',
    body_text='Here is the latest status...',
    body_html='<h1>Project Update</h1><p>Here is the latest status...</p>'
)

# Create a draft:
gmail_send(
    account='work',
    to='client@example.com',
    subject='Proposal draft',
    body_text='Please review the proposal.',
    draft=True
)

4. 整理と管理

# Archive email:
gmail_manage(account='work', action='archive', message_id='18f2a9b4c10d')

# Mark as unread:
gmail_manage(account='default', action='mark_unread', message_id='18f2a9b4c10d')

# Move to trash:
gmail_manage(account='default', action='trash', message_id='18f2a9b4c10d')

# List active accounts:
gmail_manage(action='list_accounts')

テスト

pytest tests

ライセンス

MIT

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Gmail MCP Server

    cristip73
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with Gmail through the MCP protocol, supporting sending, reading, searching, replying, forwarding, managing drafts and labels, and saving attachments.
    12
    3
    MIT

  • Moist

    TickTockBent
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables Gmail operations such as reading, sending, searching, and managing emails, threads, labels, and drafts via MCP tools.
    1
    MIT

  • Gmail MCP Connector

    deepthi-vimal
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables reading, searching, sending, and drafting Gmail emails via MCP tools, with support for multiple accounts and background notifications.

View all related MCP servers

Related MCP Connectors

  • MCP Emails

    Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.

  • sebastianall1977-gmail-mcp

    Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…

  • faithk7-gmail-mcp

    Manage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Steph-ux/gmail-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server