Skip to main content
Glama

Google MCPツール

鍛冶屋のバッジ

これは、 MCP プロトコル用の Google ネイティブ ツール (Gmail、カレンダーなど) のコレクションであり、Claude や Cursor などの AI クライアントとシームレスに統合できるように設計されています。

{
  "mcpServers": {
    "google-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "google-mcp@latest"],
      "env": {
        // Either can be used, but not both
        // Use OAuth
        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS> CAN_BE_ANYWHERE_ON_YOUR_SYSTEM",
        // Use Service Account
        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
      }
    }
  }
}

特徴

  • Gメール:

    • 複数の受信者 (宛先、CC、BCC) と添付ファイルを含む電子メールを送信します。

    • カスタム クエリ、ラベル、結果制限を使用してメールを一覧表示します。

    • ID 別に特定のメールを読み取ります。

    • ラベルを管理します(追加、削除、リスト)。

    • メールを下書きして削除します。

  • カレンダー:

    • カレンダーを一覧表示し、デフォルトのカレンダーを設定します。

    • 詳細(概要、開始/終了時間、出席者など)を含むイベントを作成します。

    • カスタマイズ可能なフィルターを使用して今後のイベントをリストします。

    • 既存のイベントを更新または削除します。

    • スケジュール用の空き時間枠を見つけます。

  • ドライブ:

    • 検索クエリでフィルタリング

    • 変更日やその他の基準で並べ替える

    • 表示数をカスタマイズする

    • 詳細なファイルメタデータを表示する

    • ファイルの内容(テキスト、ドキュメント、スプレッドシート)を読み取る

    • 指定した内容で新しいファイルを作成する

    • 既存のファイルを更新する

    • ファイルを削除する(ゴミ箱または永久)

    • 特定の権限でファイルを共有する

  • タスク:

    • すべてのタスクリストを表示

    • 新しいタスクリストを作成する

    • 既存のタスクリストを削除する

    • デフォルトのタスクリストを設定する

    • フィルターを使用してタスクを一覧表示する

    • タスクの詳細を表示

    • タイトル、メモ、期限付きのタスクを作成する

    • タスクのプロパティを更新する

    • タスクを完了としてマークする

    • タスクを削除する

  • TODO計画:

    • Google 連絡先: 連絡先を検索および管理します。

    • その他にも多数...

ワークフローのコマンドを連鎖することができます。例:

「未読メールをリストし、最新のメールへの返信を下書きし、明日午後 2 時にフォローアップ ミーティングをスケジュールします。」

手動インストール

  1. 前提条件:

    • Bunをインストールします:

    brew install oven-sh/bun/bun  # macOS/Linux with Homebrew
  2. OAuth の設定:

    • Google Cloud Consoleで Google Cloud プロジェクトを作成します。

    • OAuth 2.0 資格情報 (クライアント ID、クライアント シークレット) を設定します。

    • デスクトップ アプリの種類を選択します。

    • テスト モードを使用する場合は、テスト ユーザー リストにメールを追加します。

    • 必要なサービス (Gmail、カレンダー、ドライブなど) への API アクセスが有効になっていることを確認してください。

  3. クライアントを構成する: claude_desktop_config.json (またはクライアントの同等の構成ファイル) を編集します。

{
  "mcpServers": {
    "google-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "google-mcp@latest"],
      "env": {
        // Either can be used, but not both
        // Use OAuth
        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS>",
        // Use Service Account
        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
      }
    }
  }
}
  1. 認証:

    • サーバーを初めて起動すると、OAuth認証用のブラウザが開きます。プロンプトに従ってアクセスを許可すると、トークンがGOOGLE_OAUTH_TOKEN_PATHに保存されます。

Related MCP server: Google Search MCP Server

使用法

ここで、Claude にgoogle-mcpツールを使用するように依頼します。

Send an email to jane.doe@example.com with the subject "Meeting Notes" and body "Here are the notes from today."
List my upcoming calendar events for the next 3 days.
Create a calendar event titled "Team Sync" tomorrow at 10 AM for 1 hour.

地域開発

git clone https://github.com/vakharwalad23/google-mcp.git
cd google-mcp
bun install
bun run index.ts

Google MCP ツールをご利用いただきありがとうございます。ご質問やご提案がございましたら、お気軽に問題を報告したり、プロジェクトにご協力ください。

ツールをいろいろ試して楽しんでください!!

Available Tools

32 tools
google_calendar_create_eventC

Create a new event in Google Calendar

Inputs: end (required), start (required), summary (required), attendees, +5 more.

google_calendar_delete_eventC

Delete an event from Google Calendar

Inputs: eventId (required), calendarId.

google_calendar_find_free_timeC

Find available time slots between events

Inputs: duration (required), endDate (required), startDate (required), calendarIds.

google_calendar_get_eventC

Get detailed information about a specific event

Inputs: eventId (required), calendarId.

google_calendar_get_eventsC

Retrieve upcoming events from Google Calendar

Inputs: calendarId, limit, q, showDeleted, +2 more.

google_calendar_list_calendarsB

List all available calendars

Inputs: no named parameters.

google_calendar_set_defaultC

Set the default calendar ID for operations

Inputs: calendarId (required).

google_calendar_update_eventC

Update an existing event in Google Calendar

Inputs: eventId (required), attendees, calendarId, colorId, +6 more.

google_drive_create_fileC

Create a new file in Google Drive

Inputs: content (required), name (required), folderId, mimeType.

google_drive_delete_fileC

Delete a file from Google Drive

Inputs: fileId (required), permanently.

google_drive_get_file_contentC

Get the content of a file from Google Drive

Inputs: fileId (required).

google_drive_list_filesC

List files from Google Drive

Inputs: fields, orderBy, pageSize, query.

google_drive_share_fileC

Share a file with another user

Inputs: emailAddress (required), fileId (required), message, role, +1 more.

google_drive_update_fileC

Update the content of an existing file in Google Drive

Inputs: content (required), fileId (required), mimeType.

google_gmail_delete_emailC

Delete or trash an email

Inputs: messageId (required), permanently.

google_gmail_draft_emailC

Create a draft email

Inputs: body (required), subject (required), to (required), bcc, +2 more.

google_gmail_get_emailB

Get detailed information about a specific email

Inputs: messageId (required), format.

google_gmail_get_email_by_indexB

Get email by its index from the most recent search results

Inputs: index (required), format.

google_gmail_list_emailsC

List emails from a specific label or folder

Inputs: labelIds, maxResults, query.

google_gmail_list_labelsB

List all available Gmail labels

Inputs: no named parameters.

google_gmail_modify_labelsC

Add or remove labels from an email

Inputs: messageId (required), addLabelIds, removeLabelIds.

google_gmail_send_emailC

Send a new email

Inputs: body (required), subject (required), to (required), bcc, +2 more.

google_tasks_complete_taskC

Mark a task as completed

Inputs: taskId (required), taskListId.

google_tasks_create_taskC

Create a new task

Inputs: title (required), due, notes, taskListId.

google_tasks_create_tasklistC

Create a new task list

Inputs: title (required).

google_tasks_delete_taskC

Delete a task

Inputs: taskId (required), taskListId.

google_tasks_delete_tasklistC

Delete a task list

Inputs: taskListId (required).

google_tasks_get_taskC

Get details about a specific task

Inputs: taskId (required), taskListId.

google_tasks_list_tasklistsB

List all available task lists

Inputs: no named parameters.

google_tasks_list_tasksC

List tasks from a task list

Inputs: showCompleted, taskListId.

google_tasks_set_default_listC

Set the default task list ID for operations

Inputs: taskListId (required).

google_tasks_update_taskC

Update an existing task

Inputs: taskId (required), due, notes, status, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 32 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity, as each is scoped to a specific Google service (Calendar, Drive, Gmail, Tasks) and a specific action on a resource (e.g., create, delete, list). Overlap is minimal, such as 'google_calendar_get_event' and 'google_calendar_get_events' being clearly differentiated by singular vs. plural.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, with a clear structure: 'google_service_action_resource' (e.g., 'google_calendar_create_event'). All tools use snake_case uniformly, and verbs are predictable (create, delete, get, list, update, etc.), making the set easy to navigate.

    Tool Count3/5

    With 32 tools, the count is borderline high for a single server, as it covers multiple Google services (Calendar, Drive, Gmail, Tasks). While each service is well-scoped individually, the overall set feels heavy and might be better split into separate servers, but it's not extreme (e.g., not 50+ tools).

    Completeness5/5

    The tool surface provides complete CRUD/lifecycle coverage for each Google service domain, with no obvious gaps. For example, Calendar has create, get, list, update, delete, plus utilities like find_free_time; Gmail includes send, draft, get, list, delete, and label management; ensuring agents can handle full workflows without dead ends.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      An MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.
      262
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A locally-hosted MCP server that integrates Gmail, Google Calendar, and Google Drive to provide AI-powered management of emails, events, and files. It enables tool-based interactions like sending emails, creating calendar events, and searching Drive files through clients like Cursor and Claude Desktop.
      -