Skip to main content
Glama
enesjakozh
zacco16

Gmail MCP Server

by zacco16
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Gmail MCP サーバー

Gmail API 統合用のモデル コンテキスト プロトコル (MCP) サーバー実装。AI アシスタントが Gmail サービスと対話できるようになります。

特徴

コア機能

  • メール操作

    • 高度なフィルタリングでメールをリストする

    • 特定のメールを全文で読む

    • 新しいメールを作成して送信する

  • ドラフト管理

    • 新しい下書きを作成する

    • 既存の下書きを一覧表示する

    • 下書きコンテンツを読む

    • 下書きコンテンツと受信者を更新する

    • 下書きを削除する

  • カレンダー操作

    • 今後のカレンダーイベントを一覧表示する

    • 詳細なイベント情報を読む

    • 新しいカレンダーイベントを作成する

    • イベントのフィルタリングと検索

    • タイムゾーンのサポート

    • iOSカレンダー同期のサポート

検索とフィルタリング

  • Gmail 検索クエリのサポート

  • ラベルベースのフィルタリング

  • カスタマイズ可能な結果制限

  • カレンダーイベント検索機能

安全

  • Google OAuth2.0統合

  • 安全な資格情報管理

  • リフレッシュトークンの処理

  • マルチスコープ認証のサポート

Related MCP server: Enhanced Gmail MCP Server

クイックスタート

前提条件

  • Node.js (v14以上)

  • npm (v6以上)

  • Gmail とカレンダー API が有効になっている Google Cloud Platform アカウント

  • 適切なスコープを持つ OAuth 2.0 認証情報

インストール

  1. 依存関係をクローンしてインストールします。

    git clone [repository-url]
cd gmail-mcp-server
npm install

  2. 環境を構成する:

    # Create .env file
cp .env.example .env

# Add your credentials:
GOOGLE_CLIENT_ID="your_client_id"
GOOGLE_CLIENT_SECRET="your_client_secret"
REDIRECT_URI="http://localhost:4100/code"
GOOGLE_REFRESH_TOKEN="your_refresh_token"

  3. ビルドして実行:

    npm run build
npm start

発達

利用可能なスクリプト

  • npm run dev - ウォッチモードでビルドして実行する

  • npm run build - プロジェクトをビルドする

  • npm run clean - ビルド成果物をクリーンアップする

  • npm run watch - 変更を監視する

プロジェクト構造

gmail-mcp-server/
├── src/
│   ├── config/         # Configuration and setup
│   ├── services/       # Core business logic
│   │   ├── gmail/      # Gmail services
│   │   └── calendar/   # Calendar services
│   ├── tools/          # MCP tool implementations
│   │   ├── calendar/   # Calendar tools
│   │   ├── drafts/     # Draft management tools
│   │   └── messages/   # Email tools
│   ├── types/          # TypeScript definitions
│   └── index.ts        # Server entry point
├── dist/              # Compiled JavaScript
└── tests/             # Test files (pending)

APIインターフェース

メッセージの一覧

listEmails({
  maxResults?: number,    // Default: 10
  query?: string,         // Gmail search query
  labelIds?: string[],    // Filter by labels
  verbose?: boolean       // Include details
})

メッセージを読む

readEmail({
  messageId: string    // Message ID to fetch
})

ドラフト運営

// List Drafts
listDrafts({
  maxResults?: number,    // Default: 10
  query?: string,         // Search query
  verbose?: boolean       // Include details
})

// Read Draft
readDraft({
  draftId: string        // Draft ID to fetch
})

// Create Draft
draftEmail({
  to: string[],
  subject: string,
  body: string,
  cc?: string[],
  bcc?: string[],
  isHtml?: boolean
})

// Update Draft
updateDraft({
  draftId: string,       // Draft ID to update
  to?: string[],         // New recipients
  cc?: string[],         // New CC recipients
  bcc?: string[],         // New BCC recipients
  subject?: string,      // New subject
  body?: string,         // New body content
  isHtml?: boolean       // Content type flag
})

// Delete Draft
deleteDraft({
  draftId: string        // Draft ID to delete
})

メールを送信

sendEmail({
  to: string[],
  subject: string,
  body: string,
  cc?: string[],
  bcc?: string[],
  isHtml?: boolean,
  draftId?: string    // Optional: send existing draft
})

カレンダー操作

// List Events
listEvents({
  maxResults?: number,    // Default: 25
  timeMin?: string,       // Start time (ISO 8601)
  timeMax?: string,       // End time (ISO 8601)
  query?: string,         // Text search term
  timeZone?: string      // Default: Australia/Brisbane
})

// Read Event Details
readEvent({
  eventId: string,       // Event ID to fetch details
  timeZone?: string     // Default: Australia/Brisbane
})

// Create Event
createEvent({
  summary: string,       // Event title
  start: {
    dateTime: string,    // ISO 8601 start time
    timeZone?: string    // Start time timezone
  },
  end: {
    dateTime: string,    // ISO 8601 end time
    timeZone?: string    // End time timezone
  },
  description?: string,  // Optional event description
  location?: string,     // Optional event location
  attendees?: Array<{    // Optional attendees
    email: string,
    displayName?: string,
    optional?: boolean
  }>,
  status?: 'confirmed' | 'tentative' | 'cancelled',
  sendNotifications?: boolean
})

エラー処理

サーバーは、以下に対する包括的なエラー処理を実装します。

  • 認証失敗

  • API レート制限

  • 無効なリクエスト

  • ネットワークの問題

  • カレンダーの同期の問題

  • イベントIDの検証

  • タイムゾーンの検証

貢献

ガイドラインについてはCONTRIBUTING.mdをご覧ください。

変更履歴

バージョン履歴と更新については、 CHANGELOG.md を参照してください。

ロードマップ

計画されている機能と改善についてはBacklog.md を参照してください。

ライセンス

MIT ライセンス - 詳細についてはライセンスを参照してください。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Enhanced Gmail MCP Server

    theposch
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that enables AI assistants like Claude to interact with Gmail through natural language, providing comprehensive email management capabilities including sending, reading, organizing, searching, and managing drafts and labels.
    22
    GPL 3.0

  • Gmail AutoAuth MCP Server

    NandiniLReddy
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that enables AI assistants to manage Gmail through natural language interactions with features like sending emails, searching, and label management.
    13,749 npm
    MIT

  • Gmail MCP Server

    SolonaBot
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that enables AI assistants to search, read, and send emails with attachment support through the Gmail API. It also provides tools for comprehensive label management and uses secure OAuth2 authentication for mailbox access.
    89 npm
    MIT

Appeared in Searches