How to integrate Google Super MCP with Claude Agent SDK

This guide walks you through connecting Google Super to the Claude Agent SDK using the Composio tool router. By the end, you'll have a working Google Super agent that can share this google drive file with your team, summarize unread gmail messages from today, add a new sheet to your budget spreadsheet through natural language commands. This guide will help you understand how to give your Claude Agent SDK agent real control over a Google Super account through Composio's Google Super MCP server. Before we dive in, let's take a quick look at the key ideas and tools involved.

Get started for freeGet a demo
Google Super logoGoogle Super
Oauth2Api Key

Google Super is an all-in-one suite combining Gmail, Drive, Calendar, Sheets, Analytics, and more. It gives you a unified platform to manage your digital life, boosting productivity and organization.

402 Tools48 Triggers

Introduction

This guide walks you through connecting Google Super to the Claude Agent SDK using the Composio tool router. By the end, you'll have a working Google Super agent that can share this google drive file with your team, summarize unread gmail messages from today, add a new sheet to your budget spreadsheet through natural language commands.

This guide will help you understand how to give your Claude Agent SDK agent real control over a Google Super account through Composio's Google Super MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Google Super with

ChatGPTOpenAI Agents SDKClaude CodeClaude CoworkCodexOpenCodeCursorVS CodeOpenClawHermesCLIGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAI

TL;DR

Here's what you'll learn:
  • Get and set up your Claude/Anthropic and Composio API keys
  • Install the necessary dependencies
  • Initialize Composio and create a Tool Router session for Google Super
  • Configure an AI agent that can use Google Super as a tool
  • Run a live chat session where you can ask the agent to perform Google Super operations

What is Claude Agent SDK?

The Claude Agent SDK is Anthropic's official framework for building AI agents powered by Claude. It provides a streamlined interface for creating agents with MCP tool support and conversation management.

Key features include:

  • Native MCP Support: Built-in support for Model Context Protocol servers
  • Permission Modes: Control tool execution permissions
  • Streaming Responses: Real-time response streaming for interactive applications
  • Context Manager: Clean async context management for sessions

What is the Google Super MCP server, and what's possible with it?

The Google Super MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google Super account. It provides structured and secure access to all your core Google services—Drive, Calendar, Gmail, Sheets, Analytics, Ads, Photos, and more—so your agent can perform actions like managing files, organizing emails, updating spreadsheets, and handling media on your behalf.

  • Unified email and label management: Enable your agent to organize Gmail by adding or removing labels, and streamline inbox workflows for faster, smarter communication.
  • Spreadsheet creation and data operations: Direct your agent to create new sheets, aggregate and analyze column data, or append rows and columns to Google Sheets for seamless data management.
  • Collaborative file sharing and permissions: Have your agent update Google Drive file sharing settings, granting roles or access to users, groups, or domains effortlessly.
  • Media upload and organization in Google Photos: Let your agent batch upload media files, add them to albums, or enrich your photo library by automating media management tasks.
  • Customer and ads list management: Empower your agent to add or remove contacts from Google Ads customer lists, making marketing and outreach a breeze without manual effort.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Composio API Key and Claude/Anthropic API Key
  • Primary know-how of Claude Agents SDK
  • A Google Super account
  • Some knowledge of Python
2

Getting API Keys for Claude/Anthropic and Composio

Claude/Anthropic API Key
  • Go to the Anthropic Console and create an API key. You'll need credits to use the models.
  • Keep the API key safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Navigate to your API settings and generate a new API key.
  • Store this key securely as you'll need it for authentication.
3

Install dependencies

npm install @anthropic-ai/claude-agent-sdk @composio/core dotenv

Install the Composio SDK and the Claude Agents SDK.

What's happening:

  • @composio/core provides Composio integration for Anthropic
  • @anthropic-ai/claude-agent-sdk is the core agent framework
  • dotenv/config loads environment variables
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here

Create a .env file in your project root.

What's happening:

  • COMPOSIO_API_KEY authenticates with Composio
  • USER_ID identifies the user for session management
  • ANTHROPIC_API_KEY authenticates with Anthropic/Claude
5

Import dependencies

import 'dotenv/config';
import readline from 'node:readline';
import { Composio } from '@composio/core';
import { query, type Options } from "@anthropic-ai/claude-agent-sdk";

dotenv.config();
What's happening:
  • We're importing all necessary libraries including the Claude Agent SDK and Composio
  • The dotenv.config() function loads environment variables from your .env file
  • This setup prepares the foundation for connecting Claude with Google Super functionality
6

Create a Composio instance and Tool Router session

async function chat() {
  const { COMPOSIO_API_KEY, USER_ID } = process.env;
  if (!COMPOSIO_API_KEY || !USER_ID) {
    throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
  }

  const composio = new Composio({ apiKey: COMPOSIO_API_KEY });

  // Create Tool Router session for Google Super
  const session = await composio.create(USER_ID, {
    toolkits: ['googlesuper'],
  });
  const mcpUrl = session?.mcp.url;
What's happening:
  • The function checks for the required COMPOSIO_API_KEY environment variable
  • We're creating a Composio instance using our API key
  • The create method creates a Tool Router session for Google Super
  • The returned url is the MCP server URL that your agent will use
7

Configure Claude Agent with MCP

const options: Options = {
  permissionMode: 'bypassPermissions',
  mcpServers: {
    composio: {
      type: 'http',
      url: mcpUrl,
      headers: { 'x-api-key': COMPOSIO_API_KEY }
    }
  },
  systemPrompt: 'You are a helpful assistant with access to Google Super tools via Composio.',
  maxTurns: 10,
};
What's happening:
  • We're configuring the Claude Agent options with the MCP server URL
  • permissionMode: 'bypassPermissions' allows the agent to execute operations without asking for permission each time
  • The system prompt instructs the agent that it has access to Google Super
  • maxTurns: 10 limits the conversation length to prevent excessive API usage
8

Create client and start chat loop

const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: '
  });

  console.log('\nChat started. Type "exit" to quit.\n');

  let isProcessing = false;

  async function ask(prompt: string) {
    isProcessing = true;
    rl.pause();

    process.stdout.write('Claude is thinking...');
    const stream = query({ prompt, options });

    let firstChunk = true;
    for await (const msg of stream) {
      const content = (msg as any).message?.content || (msg as any).content;
      if (Array.isArray(content)) {
        for (const block of content) {
          if (block.type === 'text' && block.text) {
            if (firstChunk) {
              process.stdout.write('\r\x1b[K');
              process.stdout.write('Claude: ');
              firstChunk = false;
            }
            process.stdout.write(block.text);
          }
        }
      }
    }
    process.stdout.write('\n\n');

    isProcessing = false;
    rl.resume();
    rl.prompt();
  }

  rl.on('line', async (line) => {
    if (isProcessing) return;

    const input = line.trim();
    if (input === 'exit') {
      rl.close();
      process.exit(0);
    }
    if (input) await ask(input);
    else rl.prompt();
  });

  await ask('What can you help me with?');
}
What's happening:
  • The readline interface is created to handle user input and output
  • The query function is used to send the user's input to the agent
  • The chat loop continues until the user types 'exit' or 'quit'
9

Run the application

try {
  await chat();
} catch (error) {
  console.error(error);
  process.exit(1);
}
What's happening:
  • The chat function is the entry point for the application
  • The try-catch block is used to handle any errors that occur

Complete Code

Here's the complete code to get you started with Google Super and Claude Agent SDK:

import 'dotenv/config';
import readline from 'node:readline';
import { Composio } from '@composio/core';
import { query, type Options } from "@anthropic-ai/claude-agent-sdk";

async function chat() {
  const { COMPOSIO_API_KEY, USER_ID } = process.env;
  if (!COMPOSIO_API_KEY || !USER_ID) {
    throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
  }

  const composio = new Composio({ apiKey: COMPOSIO_API_KEY });
  const session = await composio.create(USER_ID, {
    toolkits: ['googlesuper']
  });
  const mcp_url = session?.mcp.url;

  const options: Options = {
    permissionMode: 'bypassPermissions',
    mcpServers: {
      composio: {
        type: 'http',
        url: mcp_url,
        headers: { 'x-api-key': COMPOSIO_API_KEY }
      }
    },
    systemPrompt: 'You are a helpful assistant with access to Google Super tools via Composio.',
    maxTurns: 10,
  };

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: '
  });

  console.log('\nChat started. Type "exit" to quit.\n');

  let isProcessing = false;

  async function ask(prompt: string) {
    isProcessing = true;
    rl.pause();

    process.stdout.write('Claude is thinking...');
    const stream = query({ prompt, options });

    let firstChunk = true;
    for await (const msg of stream) {
      const content = (msg as any).message?.content || (msg as any).content;
      if (Array.isArray(content)) {
        for (const block of content) {
          if (block.type === 'text' && block.text) {
            if (firstChunk) {
              process.stdout.write('\r\x1b[K');
              process.stdout.write('Claude: ');
              firstChunk = false;
            }
            process.stdout.write(block.text);
          }
        }
      }
    }
    process.stdout.write('\n\n');

    isProcessing = false;
    rl.resume();
    rl.prompt();
  }

  rl.on('line', async (line) => {
    if (isProcessing) return;

    const input = line.trim();
    if (input === 'exit') {
      rl.close();
      process.exit(0);
    }
    if (input) await ask(input);
    else rl.prompt();
  });

  await ask('What can you help me with?');
}

try {
  await chat();
} catch (error) {
  console.error(error);
  process.exit(1);
}

Conclusion

You've successfully built a Claude Agent SDK agent that can interact with Google Super through Composio's Tool Router.

Key features:

  • Native MCP support through Claude's agent framework
  • Streaming responses for real-time interaction
  • Permission bypass for smooth automated workflows
You can extend this by adding more toolkits, implementing custom business logic, or building a web interface around the agent.
TOOLS & TRIGGERS

Supported Tools and Triggers

Every Google Super action and event your agent gets out of the box.

Delete ACL Rule

Deletes an access control rule from a Google Calendar.

Get ACL Rule

Retrieves a specific access control rule for a calendar.

Create ACL Rule

Creates an access control rule for a calendar.

List ACL Rules

Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules.

Patch ACL Rule

Updates an existing access control rule for a calendar using patch semantics (partial update).

Update ACL Rule

Updates an access control rule for the specified calendar.

Watch ACL Changes

Tool to watch for changes to ACL resources.

Add Enrichment

Adds an enrichment at a specified position in a defined album.

Modify email labels

Adds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid (use 'listLabels' for custom label IDs).

Add or remove to customer list

AddOrRemoveToCustomerList Tool will add a contact to a customer list in Google Ads.

Insert File Parent (v2)

Tool to add a parent folder for a file using Google Drive API v2.

Insert Property (v2 API)

Tool to add a property to a file, or update it if it already exists (v2 API).

Add Sheet to Existing Spreadsheet

Adds a new sheet to a spreadsheet.

Aggregate Column Data

Searches for rows where a specific column matches a value and performs mathematical operations on data from another column.

Append Dimension

Tool to append new rows or columns to a sheet, increasing its size.

Archive Custom Dimension

Tool to archive a CustomDimension on a property.

Autocomplete Place Predictions

Returns place and query predictions for text input.

Auto-Resize Rows or Columns

Auto-fit column widths or row heights for a dimension range using batchUpdate.

Batch Add Media Items

Adds one or more media items to an album in Google Photos.

Batch Clear Values By Data Filter

Clears one or more ranges of values from a spreadsheet using data filters.

Batch Create Media Items

Batch upload and create media items in Google Photos.

Batch delete Gmail messages

Tool to permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible.

Batch Events

Execute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results.

Batch Execute Google Tasks Operations

Executes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results.

Batch get spreadsheet

Retrieves data from specified cell ranges in a Google Spreadsheet.

Batch Get Media Items

Returns the list of media items for the specified media item identifiers.

Batch modify Gmail messages

Modify labels on multiple Gmail messages in one efficient API call.

Batch Run Pivot Reports

Tool to return multiple pivot reports in a batch for a GA4 property.

Batch Run Reports

Tool to return multiple analytics data reports in a batch.

Batch Update Values by Data Filter

Tool to update values in ranges matching data filters.

Remove Calendar from List

Tool to remove a calendar from the user's calendar list.

Get Single Calendar by ID

Retrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID.

Insert Calendar into List

Inserts an existing calendar into the user's calendar list, making it visible in the UI.

Patch Calendar List Entry

Updates an existing calendar on the user's calendar list using patch semantics.

Update Calendar List Entry

Updates a calendar list entry's display/subscription settings (color, visibility, reminders, selection) for the authenticated user — does not modify the underlying calendar resource (title, timezone, etc.

Watch Calendar List

Watch for changes to CalendarList resources using push notifications.

Delete Calendar

Deletes a secondary calendar that you own or have delete permissions on.

Update Calendar

Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared.

Stop Channel

Tool to stop watching resources through a notification channel.

Check Compatibility

Tool to list dimensions and metrics compatible with a GA4 report request.

Clear Basic Filter

Tool to clear the basic filter from a sheet.

Clear Calendar

Clears a primary calendar by deleting all events from it.

Clear tasks

Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone.

Clear spreadsheet values

Clears cell content (preserving formatting and notes) from a specified A1 notation range in a Google Spreadsheet; the range must correspond to an existing sheet and cells.

Get Color Definitions

Returns the color definitions for calendars and events.

Compute Route Matrix

Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes.

Copy Google Document

Tool to create a copy of an existing Google Document.

Copy file with advanced options

Creates a copy of a file and applies any requested updates with patch semantics.

Create Album

Creates a new album in Google Photos.

Create Audience Export

Tool to create an audience export for Google Analytics.

Create Audience List

Tool to create an audience list for later retrieval by initiating a long-running asynchronous request.

Create Chart in Google Sheets

Create a chart in a Google Sheets spreadsheet using the specified data range and chart type.

Create Comment

Tool to create a comment on a file in Google Drive.

Create Custom Dimension

Tool to create a CustomDimension for a Google Analytics property.

Create customer list

Creates a customer list in Google Ads.

Create Custom Metric

Tool to create a custom metric in Google Analytics.

Create a document

Creates a new Google Docs document using the provided title as filename and inserts the initial text at the beginning if non-empty, returning the document's ID and metadata (excluding body content).

Create Document Markdown

Creates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text.

Create Shared Drive

Tool to create a new shared drive.

Create email draft

Creates a Gmail email draft.

Create Event

Create a Google Calendar event using start_datetime plus duration fields.

Create Expanded Data Set

Tool to create an expanded data set for a property.

Create File or Folder

Creates a new file or folder in Google Drive.

Create a File from Text

Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types.

Create Gmail filter

Tool to create a new Gmail filter with specified criteria and actions.

Create a folder

Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name.

Create Footer

Tool to create a new footer in a Google Document.

Create Footnote

Tool to create a new footnote in a Google Document.

Create a Google Sheet

Creates a new Google Spreadsheet in Google Drive.

Create Header

Tool to create a new header in a Google Document, optionally with text content.

Create label

Creates a new label with a unique name in the specified user's Gmail account.

Create Google Meet Space

Creates a new Google Meet space with optional configuration.

Create Named Range

Tool to create a new named range in a Google Document.

Create Paragraph Bullets

Tool to add bullets to paragraphs within a specified range in a Google Document.

Create Permission

Tool to create a permission for a file or shared drive.

Create Google Slides Presentation

Tool to create a blank Google Slides presentation.

Create Prompt Post

Send a one-shot prompt to the Sanity Content Agent.

Create Recurring Audience List

Tool to create a recurring audience list that automatically generates new audience lists daily based on the latest data.

Create Reply

Tool to create a reply to a comment in Google Drive.

Create Report Task

Tool to create a report task as a long-running asynchronous request for customized Google Analytics event data reports.

Create Rollup Property

Tool to create a roll-up property.

Create Shortcut to File/Folder

Tool to create a shortcut to a file or folder in Google Drive.

Create Slides from Markdown

Creates a new Google Slides presentation from Markdown text.

Create spreadsheet column

Creates a new column in a Google Spreadsheet.

Create spreadsheet row

Inserts a new, empty row into a specified sheet of a Google Spreadsheet at a given index, optionally inheriting formatting from the row above.

Create a task list

Creates a new task list with the specified title and returns a tasklist_id.

Delete Chart from Google Sheets

Delete an existing chart from a Google Sheets spreadsheet.

Delete Child (v2)

Tool to remove a child from a folder using Google Drive API v2.

Delete Comment

Permanently deletes a comment thread (and all its replies) from a Google Drive file — this action is irreversible.

Delete Content Range in Document

Tool to delete a range of content from a Google Document.

Delete Dimension (Rows/Columns)

Tool to delete specified rows or columns from a sheet in a Google Spreadsheet.

Delete Draft

Permanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling.

Delete Shared Drive

Tool to permanently delete a shared drive.

Delete event

Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); idempotent — a 404 for an already-deleted event is a no-op.

Delete Gmail filter

Tool to permanently delete a Gmail filter by its ID.

Delete Footer

Tool to delete a footer from a Google Document.

Delete Header

Deletes the header from the specified section or the default header if no section is specified.

Delete label from account (permanent)

Permanently DELETES a user-created Gmail label from the account (not from a message).

Delete message

Permanently deletes a specific email message by its ID from a Gmail mailbox; for `user_id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access.

Delete Named Range

Tool to delete a named range from a Google Document.

Delete Paragraph Bullets

Tool to remove bullets from paragraphs within a specified range in a Google Document.

Delete Parent (v2)

Tool to remove a parent from a file using Google Drive API v2.

Delete Permission

Deletes a permission from a file by permission ID.

Delete Property (v2 API)

Tool to delete a property from a file using Google Drive API v2.

Delete Reply

Tool to delete a specific reply by reply ID.

Delete Revision

Tool to permanently delete a file revision.

Delete Sheet

Tool to delete a sheet (worksheet) from a spreadsheet.

Delete Table Column

Tool to delete a column from a table in a Google Document.

Delete Table Row

Tool to delete a row from a table in a Google Document.

Delete task

Deletes a specified task from a Google Tasks list.

Delete task list

Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible.

Delete thread

Tool to immediately and permanently delete a specified thread and all its messages.

Download a file from Google Drive

Downloads a file from Google Drive by its ID.

Download file via operation

Tool to download file content using long-running operations.

Create a calendar

Creates a new, empty Google Calendar with the specified title (summary).

Edit File

Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB).

Empty Trash

Tool to permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive.

End active conference

Ends an active conference in a Google Meet space.

Get Event

Retrieves a SINGLE event by its unique event_id (REQUIRED).

Import Event

Tool to import an event as a private copy to a calendar.

Get Event Instances

Returns instances of the specified recurring event.

List Events

Returns events on the specified calendar.

List Events from All Calendars

Return a unified event list across all calendars in the user's calendar list for a given time range.

Move Event

Moves an event to another calendar, i.

Watch Events

Watch for changes to Events resources.

Export Google Doc as PDF

Tool to export a Google Docs file as PDF using the Google Drive API.

Export Google Workspace file

Exports a Google Workspace document to the requested MIME type and returns exported file content.

Fetch emails

Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval.

Fetch message by message ID

Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`.

Fetch Message by Thread ID

Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`.

Find event

Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types.

Find file

The comprehensive Google Drive search tool that handles all file and folder discovery needs.

Find folder

Tool to find a folder in Google Drive by its name and optionally a parent folder.

Find free slots

Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range.

Find and Replace in Spreadsheet

Tool to find and replace text in a Google Spreadsheet.

Format cell

Applies text and background cell formatting to a specified range in a Google Sheets worksheet.

Forward email message

Forward an existing Gmail message to specified recipients, preserving original body and attachments.

Generate File IDs

Generates a set of file IDs which can be provided in create or copy requests.

Geocode Address With Query

Tool to map addresses to geographic coordinates with query parameter.

Geocode Destinations

Tool to perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations, landmarks, entrances, and navigation points.

Reverse Geocode Location

Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding.

Geocode Place by ID

Tool to perform geocode lookup using a place identifier to retrieve address and coordinates.

Geocoding API

Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID.

Geolocate Device

Tool to determine location based on cell towers and WiFi access points.

Get 2D Map Tile

Tool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations.

Get 3D Tiles Root

Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering.

Get about

Tool to retrieve information about the user, the user's Drive, and system capabilities.

Get Account

Tool to retrieve a single Account by its resource name.

Get Album

Returns the album based on the specified albumId.

Get App

Tool to get information about a specific Drive app by ID.

Get Gmail attachment

Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs.

Get Attribution Settings

Tool to retrieve attribution configuration for a Google Analytics property.

Get Audience

Tool to retrieve a single Audience configuration from a Google Analytics property.

Get Audience Export

Tool to get configuration metadata about a specific audience export.

Get Audience List

Tool to get configuration metadata about a specific audience list.

Get Auto-Forwarding Settings

Tool to get the auto-forwarding setting for the specified account.

Get Google Calendar

Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access.

Get Campaign By Id

GetCampaignById Tool returns details of a campaign in Google Ads.

Get campaign by name

Queries Google Ads via SQL to retrieve a campaign by its exact name.

Get Changes Start Page Token

Tool to get the starting pageToken for listing future changes in Google Drive.

Get Child Reference (v2)

Tool to get a specific child reference for a folder using Drive API v2.

Get Comment

Tool to get a comment by ID.

Get conditional format rules

List conditional formatting rules for each sheet (or a selected sheet) in a normalized, easy-to-edit form.

Get conference record by name

Tool to get a specific conference record by its resource name.

Get contacts

Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination.

Get current date and time

Gets the current date and time, allowing for a specific timezone offset.

Get Custom Dimension

Tool to retrieve a single CustomDimension by its resource name.

Get customer lists

GetCustomerLists Tool lists all customer lists (audience/remarketing lists) in Google Ads.

Get Data Retention Settings

Tool to retrieve data retention configuration for a Google Analytics property.

Get Data Sharing Settings

Tool to retrieve data sharing configuration for a Google Analytics account.

Get Data Validation Rules

Tool to extract data validation rules from a Google Sheets spreadsheet.

Get document by id

Retrieves an existing Google Document by its ID; will error if the document is not found.

Get document plain text

Retrieve a Google Doc by ID and return a best-effort plain-text rendering.

Get Draft

Retrieves a single Gmail draft by its ID.

Get Shared Drive

Tool to get a shared drive by ID.

Get File Metadata

Tool to get a file's metadata by ID.

Get Property (v2)

Tool to get a property by its key using Google Drive API v2.

Get Gmail filter

Tool to retrieve a specific Gmail filter by its ID.

Get Google Signals Settings

Tool to retrieve Google Signals configuration settings for a GA4 property.

Get Key Event

Tool to retrieve a Key Event.

Get label details

Gets details for a specified Gmail label.

Get Language Settings

Tool to retrieve the language settings for a Gmail user.

Download Photos Media Item

Downloads a media item from Google Photos and returns it as a file.

Get Meet details

Retrieve details of a Google Meet space using its unique identifier.

Get Metadata

Tool to get metadata for dimensions, metrics, and comparisons for a GA4 property.

Get Page Thumbnail v2

Tool to generate a thumbnail of the latest version of a specified page.

Get Parent Reference (v2)

Tool to get a specific parent reference for a file using Drive API v2.

Get Participant Details

Retrieves detailed information about a specific participant session from a Google Meet conference record.

Get People

Retrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields` specifying the data to return.

Get Permission

Gets a permission by ID.

Get Permission ID for Email

Tool to get the permission ID for an email address using the Drive API v2.

Get Place Details

Retrieves comprehensive details for a place using its resource name (places/{place_id} format).

Get Profile

Retrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user.

Get Property

Tool to retrieve a single GA4 Property by its resource name.

Get Property Quotas Snapshot

Tool to retrieve all property quotas organized by category (corePropertyQuota, funnelPropertyQuota, realtimePropertyQuota) for a given GA4 property.

Get recordings by conference record ID

Retrieves recordings from Google Meet for a given conference record ID.

Get Recurring Audience List

Tool to get configuration metadata about a specific recurring audience list.

Get Reply

Tool to get a specific reply to a comment on a file.

Get Report Task

Tool to get report metadata about a specific report task.

Get Revision

Tool to get a specific revision's metadata (name, modifiedTime, keepForever, etc.

Get Route

Calculates one or more routes between two specified locations.

Get sheet names

Lists all worksheet names from a specified Google Spreadsheet (which must exist), useful for discovering sheets before further operations.

Get Spreadsheet by Data Filter

Returns the spreadsheet at the given ID, filtered by the specified data filters.

Get spreadsheet info

Retrieves metadata for a Google Spreadsheet using its ID.

Get Task

Retrieve a specific Google Task.

Get task list

Retrieves a specific task list from the user's Google Tasks if the `tasklist_id` exists for the authenticated user.

Get Transcript

Retrieves a specific transcript by its resource name.

Get Transcript Entry

Fetches a single transcript entry by resource name for targeted inspection or incremental processing.

Get transcripts by conference record ID

Retrieves all transcripts for a specific Google Meet conference using its conference_record_id.

Get Vacation Settings

Tool to retrieve vacation responder settings for a Gmail user.

Delete folder or file

Tool to delete a file or folder in Google Drive.

Hide Shared Drive

Tool to hide a shared drive from the default view.

Import message

Tool to import a message into the user's mailbox with standard email delivery scanning and classification.

Insert Child Into Folder (v2)

Tool to insert a file into a folder using Drive API v2.

Insert Dimension in Google Sheet

Tool to insert new rows or columns into a sheet at a specified location.

Insert Inline Image

Tool to insert an image from a given URI at a specified location in a Google Document as an inline image.

Insert message into mailbox

Tool to insert a message into the user's mailbox similar to IMAP APPEND.

Insert Page Break

Tool to insert a page break into a Google Document.

Insert Table in Google Doc

Tool to insert a table into a Google Document.

Insert Table Column

Tool to insert a new column into a table in a Google Document.

Insert Task

Creates a new task in a given `tasklist_id`, optionally as a subtask of an existing `task_parent` or positioned after an existing `task_previous` sibling, where both `task_parent` and `task_previous` must belong to the same `tasklist_id` if specified.

Insert Text into Document

Tool to insert a string of text at a specified location within a Google Document.

List Accessible Customers

ListAccessibleCustomers retrieves all Google Ads customer accounts accessible to the authenticated user.

List Access Proposals

Tool to list pending access proposals on a file.

List Account Summaries

Tool to retrieve summaries of all Google Analytics accounts accessible by the caller.

List Accounts (v1beta)

Tool to list all Google Analytics accounts accessible by the caller using v1beta API.

List AdSense Links

Tool to list all AdSenseLinks on a property.

List Albums

Lists all albums shown to a user in the Albums tab of Google Photos.

List All Tasks Across All Lists

Tool to list all tasks across all of the user's task lists with optional filters.

List Approvals

Tool to list approvals on a file for workflow-based access control.

List Audience Exports

Tool to list all audience exports for a property.

List Audience Lists

Tool to list all audience lists for a specified property to help find and reuse existing lists.

List Audiences

Tool to list Audiences on a property.

List BigQuery Links

Tool to list BigQuery Links on a property.

List Buildings

Lists all buildings for a Google Workspace customer account with full details including addresses, coordinates, and floor names.

List Calculated Metrics

List Calculated Metrics

List Calendar Resources

Retrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API.

List Google Calendars

Retrieves calendars from the user's Google Calendar list, with options for pagination and filtering.

List Changes

Tool to list the changes for a user or shared drive.

List Channel Groups

Tool to list ChannelGroups on a property.

List Folder Children (v2)

Tool to list a folder's children using Google Drive API v2.

List Comments

Tool to list all comments for a file in Google Drive.

List Conference Records

Tool to list conference records.

List Conversion Events

Tool to list conversion events on a property.

List CSE identities

Tool to list client-side encrypted identities for an authenticated user.

List CSE key pairs

Tool to list client-side encryption key pairs for an authenticated user.

List Custom Dimensions

List Custom Dimensions

List Custom Metrics

Tool to list CustomMetrics on a property.

List DataStreams

Tool to list DataStreams on a property.

List Drafts

Retrieves a paginated list of email drafts from a user's Gmail account.

List Display & Video 360 Advertiser Links

Tool to list Display & Video 360 advertiser links on a property.

List DisplayVideo360 Advertiser Link Proposals

Tool to list DisplayVideo360AdvertiserLinkProposals on a property.

List Event Create Rules

Tool to list EventCreateRules configured on a web data stream.

List Expanded Data Sets

Tool to list ExpandedDataSets on a property.

List File Labels

Tool to list the labels already applied to a file in Google Drive.

List Properties (v2 API)

Tool to list a file's properties in Google Drive API v2.

List Gmail filters

Tool to list all Gmail filters (rules) in the mailbox.

List Firebase Links

Tool to list FirebaseLinks on a property.

List forwarding addresses

Tool to list all forwarding addresses for the specified Gmail account.

List Google Ads Links

Tool to list GoogleAdsLinks on a property.

List Gmail history

Tool to list Gmail mailbox change history since a known startHistoryId.

List Key Events

Tool to list Key Events.

List Gmail labels

Retrieves all system and user-created labels for a Gmail account in a single unpaginated response.

List Measurement Protocol Secrets

Tool to list MeasurementProtocolSecrets under a data stream.

List Media Items (App-Created Only)

Lists media items created by this application from Google Photos.

List Participants

Lists the participants in a conference record.

List Participant Sessions

Lists all participant sessions for a specific participant in a Google Meet conference.

List Permissions

Tool to list a file's permissions.

List Property

Tool to list GA4 properties based on filter criteria.

List Recordings

Tool to list recording resources from a conference record.

List Recurring Audience Lists

Tool to list all recurring audience lists for a GA4 property.

List Replies to Comment

Tool to list replies to a comment in Google Drive.

List Reporting Data Annotations

Tool to list all Reporting Data Annotations for a specific property.

List Report Tasks

Tool to list all report tasks for a Google Analytics property.

List File Revisions

Tool to list a file's revision metadata (not content) in Google Drive.

List Search Ads 360 Links

Tool to list all SearchAds360Links on a property.

List send-as aliases

Lists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases.

List Shared Drives

Tool to list the user's shared drives.

List SKAdNetwork Conversion Value Schemas

Tool to list SKAdNetworkConversionValueSchema configurations for an iOS data stream.

List S/MIME configs

Lists S/MIME configs for the specified send-as alias.

Get Charts from Spreadsheet

Tool to retrieve a list of all charts from a specified Google Sheets spreadsheet.

List Subproperty Event Filters

Tool to list all subproperty event filters on a property.

List Subproperty Sync Configs

Tool to list SubpropertySyncConfig resources for managing subproperty synchronization configurations.

List task lists

Fetches the authenticated user's task lists from Google Tasks; results may be paginated.

List Tasks

Retrieves tasks from a Google Tasks list; all date/time strings must be RFC3339 UTC, and `showCompleted` must be true if `completedMin` or `completedMax` are specified.

List threads

Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination.

List Transcript Entries

Tool to list structured transcript entries (speaker/time/text segments) for a specific Google Meet transcript.

Lookup Aerial Video

Tool to look up an aerial view video by address or video ID.

Look up spreadsheet row

Finds the first row in a Google Spreadsheet where a cell's entire content exactly matches the query string, searching within a specified A1 notation range or the first sheet by default.

Embed Google Map

Tool to generate an embeddable Google Map URL and HTML iframe code.

Modify File Labels

Modifies the set of labels applied to a file.

Modify thread labels

Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid.

Move File

Tool to move a file from one folder to another in Google Drive.

Move Task

Moves the specified task to another position in the task list or to a different task list.

Trash thread

Moves the specified thread to the trash.

Move to Trash

Moves an existing, non-deleted email message to the trash for the specified user.

Mutate Ad Groups

Create, update, or remove ad groups within Google Ads campaigns.

Mutate Campaigns

Create, update, or remove Google Ads campaigns in batch.

Mutate conditional format rules

Add, update, delete, or reorder conditional format rules on a Google Sheet.

Nearby search

Searches for places (e.

Patch Calendar

Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided.

Patch Event

Update specified fields of an existing event in a Google Calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar_id` and `event_id` are valid and the user has write access to the calendar.

Patch Label

Patches the specified user-created label.

Patch Permission

Tool to update a permission using patch semantics.

Patch Property (v2 API)

Tool to update a property on a file using PATCH semantics (v2 API).

Patch send-as alias

Tool to patch the specified send-as alias for a Gmail user.

Patch Task

Partially updates an existing task (identified by `task_id`) within a specific Google Task list (identified by `tasklist_id`), modifying only the provided attributes from `TaskInput` (e.

Patch task list

Updates the title of an existing Google Tasks task list.

Get Place Photo

Retrieves high quality photographic content from the Google Maps Places database.

Update Presentation (Batch/Markdown)

Update Google Slides presentations using markdown content or raw API text.

Copy Google Slides from Template

Tool to create a new Google Slides presentation by duplicating an existing template deck via Drive file copy.

Get Presentation

Tool to retrieve the latest version of a presentation.

Get Presentation Page

Tool to get the latest version of a specific page in a presentation.

Provision Account Ticket

Tool to request a ticket for creating a Google Analytics account.

Query Audience Export

Tool to query a completed audience export.

Query Audience List

Tool to query an audience list.

Query Report Task

Tool to retrieve a report task's content.

Quick Add Event

Parses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring events, and `calendar_id` must be valid if not 'primary'.

Remove attendee from event

Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist.

Render Aerial Video

Starts rendering an aerial view video for a US postal address.

Replace All Text in Document

Tool to replace all occurrences of a specified text string with another text string throughout a Google Document.

Replace Image in Document

Tool to replace a specific image in a document with a new image from a URI.

Reply to email thread

Sends a reply within a specific Gmail thread using the original thread's subject; do not provide a custom subject as it will start a new conversation instead of replying in-thread.

Resumable Upload

Tool to start and complete a Google Drive resumable upload session.

Run Funnel Report

Tool to run a GA4 funnel report.

Run Pivot Report

Tool to run a customized pivot report of Google Analytics event data.

Run Realtime Report

Tool to run a customized realtime report of Google Analytics event data.

Run Report

Tool to run a customized GA4 data report.

Search Developer Metadata

Tool to search for developer metadata in a spreadsheet.

Search Documents

Search for Google Documents using various filters including name, content, date ranges, and more.

Search Media Items

Searches for media items in a user's Google Photos library.

Search People

Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'.

Search Spreadsheets

Search for Google Spreadsheets using various filters including name, content, date ranges, and more.

Search Stream GAQL

Execute a Google Ads Query Language (GAQL) query and stream all results in a single response.

Send Draft

Sends an existing draft email AS-IS to recipients already defined within the draft.

Send Email

Sends an email via Gmail API using the authenticated user's Google profile display name.

Send Events

Tool to send event data to Google Analytics 4 using the Measurement Protocol.

Set Basic Filter

Tool to set a basic filter on a sheet in a Google Spreadsheet.

Set Data Validation Rule

Tool to set or clear data validation rules (including dropdowns) on a range in Google Sheets.

Get Calendar Setting

Tool to return a single user setting for the authenticated user.

Get IMAP Settings

Retrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size.

Get POP settings

Tool to retrieve POP settings for a Gmail account.

List Settings

Returns all user settings for the authenticated user.

Get send-as alias

Tool to retrieve a specific send-as alias configuration for a Gmail user.

Watch Settings

Watch for changes to Settings resources.

Copy Sheet to Another Spreadsheet

Tool to copy a single sheet from a spreadsheet to another spreadsheet.

Append Values to Spreadsheet

Tool to append values to a spreadsheet.

Batch Clear Spreadsheet Values

Tool to clear one or more ranges of values from a spreadsheet.

Batch Get Spreadsheet Values by Data Filter

Tool to return one or more ranges of values from a spreadsheet that match the specified data filters.

Stop watch notifications

Tool to stop receiving push notifications for a Gmail mailbox.

Stop Watch Channel

Tool to stop watching resources through a specified channel.

Text Search

Searches for places on Google Maps using a textual query (e.

Create Tiles Session

Tool to create a session token required for accessing 2D Tiles and Street View imagery.

Trash File

Tool to move a file or folder to trash (soft delete).

Unhide Shared Drive

Tool to unhide a shared drive.

Unmerge Table Cells

Tool to unmerge previously merged cells in a table.

Untrash File

Tool to restore a file from the trash.

Untrash Message

Tool to remove a message from trash in Gmail.

Untrash thread

Tool to remove a thread from trash in Gmail.

Update Album

Updates an album's title or cover photo in Google Photos.

Update Chart in Google Sheets

Update the specification of an existing chart in a Google Sheets spreadsheet.

Update Comment

Tool to update an existing comment on a Google Drive file.

Update Dimension Properties (Hide/Unhide & Resize)

Tool to hide/unhide rows or columns and set row heights or column widths.

Update Document Markdown

Replaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document.

Update Document Section Markdown

Tool to insert or replace a section of a Google Docs document with Markdown content.

Update Document Style

Tool to update the overall document style, such as page size, margins, and default text direction.

Update draft

Updates (replaces) an existing Gmail draft's content in-place by draft ID.

Update Shared Drive

Tool to update the metadata for a shared drive.

Update Google event

Updates an existing event in Google Calendar.

Update existing document

Applies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method.

Update File Metadata (PATCH v2)

Tool to update file metadata using the Drive API v2 PATCH method.

Update Property (v2 API)

Tool to update a property on a file using Google Drive API v2.

Update File (Metadata)

Updates file metadata.

Update File Revision Metadata

Updates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain).

Update IMAP settings

Tool to update IMAP settings for a Gmail account.

Update Label

Tool to update the properties of an existing Gmail label.

Update Language Settings

Tool to update the language settings for a Gmail user.

Update Media Item

Updates a media item's description in Google Photos.

Update Permission

Tool to update a permission with patch semantics.

Update POP settings

Tool to update POP settings for a Gmail account.

Update Property

Tool to update an existing GA4 Property.

Update Reply

Tool to update a reply to a comment on a Google Drive file.

Update send-as alias

Tool to update a send-as alias for a Gmail user.

Update Sheet Properties

Tool to update properties of a sheet (worksheet) within a Google Spreadsheet, such as its title, index, visibility, tab color, or grid properties.

Update Google Meet Space

Updates the settings of an existing Google Meet space.

Update Spreadsheet Properties

Tool to update SPREADSHEET-LEVEL properties such as the spreadsheet's title, locale, time zone, or auto-recalculation settings.

Update Table Row Style

Tool to update the style of a table row in a Google Document.

Update Task (Full Replacement)

Tool to fully replace an existing Google Task using PUT method.

Update Task List

Updates the authenticated user's specified task list.

Update User Attributes Values

Update user attribute values for a resource.

Update Vacation Settings

Tool to update vacation responder settings for a Gmail user.

Batch update spreadsheet values

Tool to set values in one or more ranges of a spreadsheet.

Upload File

Uploads a file (max 5MB) to Google Drive, placing it in the specified folder or root if no valid folder ID is provided.

Upload File from URL to Drive

Tool to fetch a file from a provided URL server-side and upload it into Google Drive.

Upload Media

Upload a media file to Google Photos.

Upload/Update File Content

Tool to update file content in Google Drive by uploading new binary content.

Upsert Rows (Smart Update/Insert)

Upsert rows - update existing rows by key, append new ones.

Validate Events

Tool to validate Measurement Protocol events before sending them to production.

Get spreadsheet values

Returns a range of values from a spreadsheet.

Update spreadsheet values

Tool to set values in a range of a Google Spreadsheet.

Watch Drive Changes

Tool to subscribe to changes for a user or shared drive in Google Drive.

Watch File for Changes

Tool to subscribe to push notifications for changes to a specific file.

FRAMEWORKS

How to build Google Super MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Google Super MCP with ChatGPT

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Google Super MCP with OpenAI Agents SDK

Claude Code logo

Claude Code

Use Google Super MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Google Super MCP with Claude Cowork

Codex logo

Codex

Use Google Super MCP with Codex

Cursor logo

Cursor

Use Google Super MCP with Cursor

OpenClaw logo

OpenClaw

Use Google Super MCP with OpenClaw

Hermes logo

Hermes

Use Google Super MCP with Hermes

CLI logo

CLI

Use Google Super MCP with CLI

Google ADK logo

Google ADK

Use Google Super MCP with Google ADK

LangChain logo

LangChain

Use Google Super MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Google Super MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Google Super MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Google Super MCP with LlamaIndex

CrewAI logo

CrewAI

Use Google Super MCP with CrewAI

OpenCode logo

OpenCode

Use Google Super MCP with OpenCode

VS Code logo

VS Code

Use Google Super MCP with VS Code

FAQ

Frequently asked questions

With a standalone Google Super MCP server, the agents and LLMs can only access a fixed set of Google Super tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Google Super and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Agent SDK fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Google Super tools.

Yes, absolutely. You can configure which Google Super scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Google Super data and credentials are handled as safely as possible.

Start with Google Super.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google Super tool your agent needs.Free to start.

Start building
Customer stories

Teams ship real agents on Composio

GET STARTED FOR FREEBOOK A DEMO
agent.aiZoomLettaGleanHubSpotAWSWabi

Karan skipped his own birthday party to fix our critical issue. It was 10pm and he diverted his Waymo to help us instead. This really sets the bar — it shows the commitment you need when users rely on your software.

Harsha Gaddipati
Harsha Gaddipati
Co-founder, Slashy

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it's immensely helped keep new users on the platform.

Abhi Arya
Abhi Arya
Co-founder, Opennote

We chose Composio over Pipedream because it delivered depth where it mattered — niche tools and tricky edge cases other platforms simply ignored. That gave us confidence to scale without compromising.

Nirman Dave
Nirman Dave
CEO, Zams

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down managing agent auth would have been a death sentence.

Ryan Yu
Ryan Yu
Founder, Extra Thursday

Before Composio, adding tool integrations was slow and resource-intensive. Each one could take weeks of engineering time, and maintaining them meant constantly keeping up with API changes.

Tomisin Jenrola
Tomisin Jenrola
Founder & CEO, SwarmZero

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Jerome Leclanche
Jerome Leclanche
Co-Founder, Ingram Technologies