How to integrate Google Drive MCP with Atomic Agent

Connect Atomic Agent to Google Drive MCP. Create a new folder named 'invoices', share last uploaded file with your team, and more using natural language, with authentication handled for you.

Google Drive logoGoogle Drive
Oauth2

Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices.

92 Tools7 Triggers

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Google Drive.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Google Drive account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Google Drive with

How Atomic Agent connects to Google Drive

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Google Drive to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Google Drive. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Google Drive account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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

The Google Drive 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 Drive account. It provides structured and secure access to your files, folders, comments, permissions, and shared drives, so your agent can search, create, download, share, and organize content on your behalf.

  • File and folder management: Have your agent find files, create files and folders, inspect file details, add shortcuts, and download stored content.
  • Workspace file exports and spreadsheet reads: Let the agent export Google Workspace files to supported formats or read multiple ranges from a Google Spreadsheet.
  • Sharing and permission control: Direct your agent to view, add, or remove access permissions for files and shared drives.
  • Comments and collaboration: Instruct your agent to list and create file comments, reply to existing comments, or remove comments and replies.
  • Shared drives and file history: Have your agent list, create, inspect, hide, or delete shared drives, and review or download file revisions.

Use Google Drive from Atomic Agent

With your account connected, ask Atomic Agent to work with Google Drive in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS & TRIGGERS

Supported Tools and Triggers

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

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).

Batch Get Spreadsheet Values

Read multiple explicit ranges from one Google Spreadsheet in one request.

Batch Update Spreadsheet Values

Write values to multiple Google Sheets ranges in one batch request.

Clear Spreadsheet Values

Permanently clear values from one range while preserving formatting, notes, and validation.

Copy file with advanced options

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

Create Comment

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

Create Shared Drive

Creates a Google shared drive for collaboration or storage.

Create File or Folder

Creates a new file or folder in Google Drive.

Create a File from Text

Creates a Google Drive file from text, with support for Google Workspace formats and an optional parent folder.

Create a folder

Creates a Google Drive folder, optionally inside an existing parent specified by ID or exact name.

Create Permission

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

Create Permissions Batch

Creates multiple permissions for files or shared drives in a single batch request.

Create Reply

Create a plain-text reply to a comment on a Google Drive file, optionally resolving or reopening the parent comment.

Create Shortcut to File/Folder

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

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 Shared Drive

Tool to permanently delete a shared drive.

Delete Parent (v2)

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

Delete Permission

Deletes a specified permission from a file or shared drive by permission ID; deleting other permissions does not remove an existing public-access permission.

Delete Property (v2 API)

Delete a custom property from a Google Drive file using API v2.

Delete Reply

Tool to delete a specific reply by reply ID.

Delete Revision

Tool to permanently delete a file revision.

Download a file from Google Drive

Downloads a Drive file's content and returns it in `downloaded_file_content`.

Download file via operation

Starts a long-running operation to download a Drive file, including Google Vids files, or export supported Google Workspace documents.

Download File Revision

Download the stored bytes of one blob-file revision.

Edit File

Replaces the entire content of an existing Google Drive binary file with UTF-8 text while retaining its file ID.

Empty Trash

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

Export Google Workspace file

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

Find file

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

Find folder

Finds one page of Google Drive folders by name and optional parent.

Generate File IDs

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

Get about

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

Get App

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

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 Document

Retrieve a native Google Docs document's structured content and metadata by ID.

Get Shared Drive

Tool to get a shared drive by ID.

Get File Metadata

Gets a Drive file's metadata by ID, optionally returning only the metadata selected by `fields`.

Get Property (v2)

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

Get Google Form

Retrieve a Google Form's definition, questions, settings, and publishing state by ID.

Get Parent Reference (v2)

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

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 Google Slides Presentation

Retrieves a Google Slides presentation by ID, including its page structures.

Get Presentation Page Thumbnail

Generate one short-lived page thumbnail URL using an expensive Slides quota read.

Get Reply

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

Get Revision

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

Get Spreadsheet

Retrieve a Google Spreadsheet's structure, metadata, and selected grid data.

Get Spreadsheet Values

Read values from one range in a Google Spreadsheet.

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.

Insert Child Into Folder (v2)

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

List Access Proposals

Tool to list pending access proposals on a file.

List Approvals

Lists a page of approvals associated with a Google Drive file, with pagination for browsing subsequent pages.

List Changes

Lists a page of changes for a user or shared drive; without a page token, it obtains a current start token and lists subsequent changes rather than earlier activity.

List Folder Children (v2)

Lists a page of child references for a folder using Google Drive API v2.

List Comments

Lists comments on a Google Drive file, with pagination, an option to include deleted comments, and a minimum modification-time filter.

List File Labels

Lists labels applied to a Google Drive file, including label IDs and applied field IDs.

List Properties (v2 API)

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

List Google Form Responses

Return one page of submissions for a Google Form.

List Label Definitions

Lists available Google Drive labels, returning each label's ID and display name without requiring a file ID.

List Permissions

Lists a page of permissions for a file or shared drive.

List Replies to Comment

List a page of replies to a specific comment on a Google Drive file.

List File Revisions

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

List Shared Drives

Tool to list the user's shared drives.

Modify File Labels

Modifies the set of labels applied to a file.

Move File

Moves a file to another Google Drive folder.

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).

Read Spreadsheet Values

Read values from one or more ranges in a Google spreadsheet.

Resumable Upload

Upload a file to Google Drive using a resumable session, creating a new file or updating an existing file by ID.

Stop Watch Channel

Tool to stop watching resources through a specified channel.

Trash File

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

Unhide Shared Drive

Tool to unhide a shared drive.

Untrash File

Restore a file from Google Drive trash.

Update Comment

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

Update Shared Drive

Tool to update the metadata for a shared drive.

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 Permission

Tool to update a permission with patch semantics.

Update Reply

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

Update Spreadsheet Values

Write values to one exact Google Sheets range.

Upload File

Upload a new file to Google Drive, optionally placing it in a specified folder.

Upload File from URL to Drive

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

Upload/Update File Content

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

Watch Drive Changes

Subscribe to Google Drive changes for a user or shared drive and receive notifications at a webhook URL.

Watch File for Changes

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

Write Spreadsheet Values

Replace values in one range of a Google spreadsheet.

FAQ

Frequently asked questions

Start with Google Drive.It takes 30 seconds.

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

Start building