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 認証情報

インストール

依存関係をクローンしてインストールします。
git clone [repository-url] cd gmail-mcp-server npm install
環境を構成する:
# 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"
ビルドして実行:
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 ライセンス - 詳細についてはライセンスを参照してください。

Gmail MCP Server