Google Slides MCP

Google Slides MCP

英語 | ロシア語

A1 Google Slides MCP を使うと、AI アプリから自然な言葉で Google Slides のプレゼンテーションを作成・編集できます。スライドの下書きを作成し、スライドを追加・並べ替え、テキストを作成・スタイル設定し、図形、画像、表を配置できます。また、発表者ノートやコメントを管理し、完成した資料を PDF や PPTX としてエクスポートできます。

Google アカウントを使用して Google Slides API を利用します。デッキ内のすべての要素には明示的なオブジェクト ID でアクセスします。また、あらゆるプレゼンテーション作業が可能であるかのように装わず、Slides API の制限を明示します。

• 32 個のツール。 デッキやページの確認、スライド、テキスト、図形、画像、表の編集、発表者ノートやコメントの管理、サムネイルのレンダリング、ファイルのエクスポートができます。
• 会話から接続できます。 「Google Slides に接続して」と言うと、サーバーが OAuth クライアントの設定を案内し、PKCE を使って 127.0.0.1 への Google のリダイレクトを受け取り、トークンを自身で保持します。設定ファイルも再起動も不要です。
• 編集はアトミックです。 変更は API の batchUpdate で実行されます。無効なリクエストが 1 つでもあるとバッチ全体が取り消されるため、デッキが中途半端な状態になることはありません。
• Drive 内の他のファイルにはアクセスしません。 コメント、エクスポート、ローカル画像のアップロードには、対象のプレゼンテーションファイル 1 つに限って Drive API を使用します。Drive ファイルの一覧表示、共有、名前変更、削除を行うツールはありません。
• Google のスコープを最小限に抑えています。 presentations が必要です。Drive のスコープが必要なのは、ローカル画像、コメント、エクスポートを利用する場合のみです。

まずは読み取り専用の質問から始めましょう。

四半期報告のデッキにあるスライドと、それぞれの内容を見せてください。

サーバーに接続する · ユースケースを見る · 技術ドキュメントを開く

1 分で動作を確認

あなた： Q3 レビューのデッキにあるスライドと、それぞれの内容を一覧表示してください。

アシスタント： 各スライドの位置、レイアウト、表示されているテキストを含む要素を、簡潔な一覧で表示します。変更は行いません。

あなた： アジェンダの次に「Roadmap」というタイトルの新しいスライドを作成し、本文に重要な日付を入れてください。

アシスタント： 対象のデッキ、レイアウト、提案するテキストを表示し、追加する前に確認を求めます。

あなた： 確認します。

アシスタント： スライドを追加し、プレースホルダーに内容を入力します。他のスライドには触れません。

目次

• クイックスタート
• 依頼できること
• プレゼンテーションの変更方法
• 変更できる内容
• アクセスの取得
• 設定
• データ、制限、バックグラウンド処理
• 技術ドキュメント
• サポート

クイックスタート

Node.js 20+ と Google アカウントが必要です。インストール時に認証情報は不要です。サーバーは会話から接続します。

1. AI アプリにサーバーを追加します。
2. 「connect Google Slides」と伝えると、設定ファイルを編集せずに、アシスタントがOAuth クライアントの作成とアクセスの承認を案内します。
3. 上記の読み取り専用の質問をします。

codex mcp add google-slides \
  -- npx -y @a1-x-tech/mcp-google-slides@latest

codex mcp list

claude mcp add \
  --transport stdio --scope user google-slides \
  -- npx -y @a1-x-tech/mcp-google-slides@latest

claude mcp list

{
  "mcpServers": {
    "google-slides": {
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-slides@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-slides": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-slides@latest"]
    }
  }
}

{
  "servers": {
    "google-slides": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-slides@latest"]
    }
  }
}

できること

スライドを確認する

• このプレゼンテーションのスライドと、それぞれの内容を一覧表示してください。
• スライド 5 の発表者ノートを読んでください。
• タイトルスライドのサムネイルをレンダリングしてください。

スライドを作成・並べ替える

• Q3 レビュー用のプレゼンテーションを作成してください。
• アジェンダの後に「Roadmap」スライドを追加し、テンプレートスライドを複製して、まとめを最後に移動してください。
• URL またはローカルファイルの画像を挿入し、4×3 の表を追加して、テキストボックスまたはキャプション付きの角丸長方形を作成してください。

テキストを作成・推敲する

• このテキストをタイトルのプレースホルダーに入れて、期限を太字の赤色にしてください。
• スライド全体で「Q2」を「Q3」に置き換えてください。
• スライド 3 の発表者ノートを短く書き直してください。

レビューして引き継ぐ

• 未解決のコメントスレッドを一覧表示し、最初のスレッドに返信して解決してください。
• 不要になった下書きのスライドを削除してください。
• Google アクセス権のない人向けに、プレゼンテーションを PDF または PPTX でエクスポートしてください。

プレゼンテーションの変更方法

1. create_presentation はタイトルスライドを1枚含むデッキを作成します。作成時に反映されるのはタイトルのみです。
2. デッキ内のすべての要素（スライド、図形、画像、表）は、オブジェクト IDで指定します。編集を始める前に、まず list_slides で簡潔な一覧を確認してください。
3. 編集は API のアトミックな batchUpdate を通じて行われます。無効なリクエストが1つでもあるとバッチ全体が無効になり、変更が一部だけ適用されることはありません。
4. ツールの入力単位はポイントで、API では EMU（1 pt = 12700 EMU）として保存されます。サーバーが双方向の変換を行います。

Slides API ではプレゼンテーションファイルの削除、名前変更、共有はできません。これらはこのサーバーの対象範囲外である Drive ファイル操作です。また、テーマのインポート（デッキに既存のレイアウトのインスタンス化のみ可能）や、特定のスライドに新しいコメントを固定することもできません。エクスポートの上限は 10 MB で、サムネイル URL は約 30 分後に期限切れになります。

変更できる内容

確認プロンプトは AI クライアントが制御します。サーバーは読み取り、書き込み、破壊的なツールをマークするため、クライアントは確認操作と実際の変更を区別できます。

アクセスの取得

Google Slides には OAuth 2.0 が必要です。API キーだけでは不十分です。アクセス方法は2つあり、最初の方法では設定ファイルは不要です。

チャットから接続する（推奨）

「connect Google Slides」と伝えると、アシスタントが一緒に手順を進めます。

1. setup_instructions がチェックリストを表示します。Google Cloud プロジェクトの作成または選択、Google Slides API の有効化、同意画面の設定、Desktop app OAuth クライアントの作成を行います。
2. そのクライアントの JSON（「Download JSON」）をダウンロードし、アシスタントにそのパスを伝えます。set_client が所有者のみ読み取り可能な状態で保存します。シークレットが会話を通じて送信されることはありません。
3. start_login が Google の同意リンクを返します。このマシン上でリンクを開いて承認してください。コードは 127.0.0.1 上のワンショットリスナー（PKCE）に返され、チャットを経由することはありません。
4. finish_login がコードを交換し、トークンを ~/.config/mcp-google-slides/credentials.json（モード 0600）に保存します。

トークンは呼び出しごとに再読み込みされるため、AI アプリを再起動しなくても接続はすぐに有効になります。auth_status で接続状態を確認でき、logout で接続を取り消して認証情報を削除できます。

環境変数（CI、無人インストール）

1. Google Cloud プロジェクトを作成または選択し、Google Slides API を有効にします。コメント、エクスポート、ローカル画像のアップロードを利用する場合は、Google Drive API も有効にします。

2. OAuth 同意画面を設定し、デスクトップアプリの OAuth クライアントを作成します。

3. プレゼンテーションの所有者、または編集権限を持つ Google アカウントを認証します。OAuth 2.0 Playground では、Use your own OAuth credentials を有効にすると、リフレッシュトークンを取得できます。

4. 次のスコープをリクエストします。

   https://www.googleapis.com/auth/presentations
   https://www.googleapis.com/auth/drive.file
   

   presentations は、Slides のすべての読み取りと書き込みを対象とします。drive.file は、このアプリで作成したプレゼンテーションに対するローカル画像のアップロード、コメント、エクスポートを対象とします。任意のプレゼンテーションでコメントやエクスポートを利用する必要がある場合は、代わりに、より広範な https://www.googleapis.com/auth/drive をリクエストしてください。

テストモードの OAuth リフレッシュトークンは、7 日後に期限切れになることがあります。長期間アクセスする必要がある場合は、OAuth アプリを公開するか、Workspace ドメインの内部アプリを使用してください。クライアントシークレットとリフレッシュトークンはパスワードとして扱ってください。

設定

すべての変数は任意です。設定しなくても、サーバーはチャットから接続します。

* OAuth の 3 つの値、またはアクセストークンのいずれかを指定してください。

データ、制限、バックグラウンド処理

• リクエストは Google Slides に送信されます。 ローカルサーバーは Google OAuth トークンを更新して Slides API を呼び出します。コメント、エクスポート、ローカル画像のアップロードには Drive API を使用し、対象は該当するプレゼンテーションファイル 1 つに限定されます。匿名のテレメトリに含まれるのは、インストール ID、パッケージバージョン、AI クライアントとプラットフォームのバージョン、ツール名です。OAuth トークン、プレゼンテーションの内容、ツールの引数、プロンプトは含まれません。オプトアウトするには ASKADS_TELEMETRY=0 を設定します。
• Google にはレート制限があります。 429 の場合、サーバーはバックオフを使用します。読み取りはネットワークエラーや 5xx エラーの後にも再試行しますが、失敗したかどうかが不確かな書き込みは再実行しません。サムネイルは、よりコストの高い読み取りクォータを消費します。
• バックグラウンドでのポーリングはありません。 サーバーは呼び出されたときだけ実行されます。呼び出しの間にプレゼンテーションを監視することはありません。AI アプリがスケジュールタスクに対応している場合は、プレゼンテーションを定期的に確認できます。

技術ドキュメント

• MCP 機能カタログ — 各ツールのタスク別ページ。
• すべてのツールと入力
• 開発ドキュメント
• 公開ドキュメント
• Google Slides API リファレンス

サポート

バグを見つけた場合や、特定のシナリオへの対応が必要な場合は、Issue を作成するか、Telegram にご連絡ください。

最後までご覧いただき、ありがとうございます！