Connect your AI Agents to Google Drive in minutes

Merge lets you securely connect your agents to Google Drive and thousands of tools instantly

Available tools

list_comments

List all comments and replies on a Google Drive file with pagination support

get_comment

Get details of a specific comment

create_comment

Add a new comment to a Google Drive file with optional text anchoring and rich formatting

update_comment

Update the content of an existing comment on a Google Drive file

delete_comment

Permanently delete a comment and all its replies from a Google Drive file

resolve_comment

Mark a suggestion comment as resolved - ONLY works for suggestion comments (not regular comments) in Google Docs/Sheets/Slides

list_replies

List all replies to a specific comment with pagination and filtering options

create_reply

Add a reply to an existing comment thread on a Google Drive file

update_reply

Update an existing reply to a comment

delete_reply

Permanently delete a specific reply from a comment thread

list_drives

List all shared drives (Team Drives) accessible to the user

get_drive

Get detailed information about a specific shared drive

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11
Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}
Copy Code
Copied!

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }
Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}
Copy Code

FAQs on using Merge's Google Drive  MCP server

FAQs on using Merge's Google Drive  MCP server

What are common use cases for the Google Drive MCP server?

Your top use cases hinge on the type of agents you support. That said, here are several common agentic use cases for Google Drive:

  • Document generation: Your agent can automatically create and populate Google Docs with meeting notes, weekly reports, or customer onboarding materials based on data from CRM or project management systems
  • Content organization: Your agent can monitor new files, automatically organize them into appropriate folders based on file type, project tags, or metadata, and apply consistent naming conventions
  • Compliance archiving: Your agent can identify files that meet retention criteria, move them to designated archive folders, and update permissions to ensure regulatory compliance
  • Onboarding automation: Your agent can create personalized folder structures and populate them with relevant documents, templates, and resources when new team members join
  • Contract management: Your agent can extract key dates from contracts stored in Drive, create reminders for renewal deadlines, and notify stakeholders when agreements are approaching expiration

What are popular tools for Google Drive’s MCP server?

Here are several popular tools broken down by data types:

Drives

  • <code class="blog_inline-code">list_drives</code>
  • <code class="blog_inline-code">get_drive</code>
  • <code class="blog_inline-code">create_drive</code>
  • <code class="blog_inline-code">hide_drive</code>

Files

  • <code class="blog_inline-code">list_files</code>
  • <code class="blog_inline-code">get_file</code>
  • <code class="blog_inline-code">create_file</code>
  • <code class="blog_inline-code">update_file</code>
  • <code class="blog_inline-code">copy_file</code>

Permissions

  • <code class="blog_inline-code">list_permission</code>
  • <code class="blog_inline-code">get_permission</code>
  • <code class="blog_inline-code">create_permission</code>
  • <code class="blog_inline-code">batch_create_permissions</code>

What makes Merge Agent Handler’s Google Drive MCP server better than alternative Google Drive MCP servers?

Merge Agent Handler adds enterprise-grade infrastructure and controls on top of MCP:

  • Enterprise-grade security and DLP: All Google Drive tool inputs and outputs are inspected by a security gateway with configurable data loss prevention rules to block, redact, or mask sensitive data
  • Managed authentication: Merge handles credential storage, validation, and dynamic authorization flows, eliminating the need for custom Google OAuth handling in your agent code
  • Real-time observability and audit trails: Every Google Drive tool call is logged with a fully searchable audit trail for debugging, auditing, and optimization
  • Pre-production validation: The Evaluation Suite allows teams to test Google Drive tools against expected outcomes before deploying them to production

Can I set custom security rules for Google Drive tool calls in Merge Agent Handler?

You can easily set a wide range of rules. Here are just a few examples:

  • Credit card numbers: Block any <code class="blog_inline-code">create_file</code> or <code class="blog_inline-code">update_file</code> tool calls that contain credit card numbers in the document content or file name before they're written to Google Drive
  • Email addresses: Redact email addresses from <code class="blog_inline-code">read_file</code> or <code class="blog_inline-code">search_files</code> responses, so agents only see masked versions (e.g., j*@merge.dev) when retrieving document content
  • Phone numbers: Automatically redact phone numbers from file content and metadata when agents retrieve them via <code class="blog_inline-code">get_file</code> or <code class="blog_inline-code">download_file</code> operations
  • External sharing: Block <code class="blog_inline-code">share_file</code> tool calls that attempt to share documents with email addresses outside your organization's domain

How can I add tools to Merge Agent Handler's Google Drive MCP server?

Here are the steps you can take within the Connector Studio:

1. Start with Merge’s pre-built Google Drive connector. The connector provides dozens of out-of-the-box tools that are maintained by Merge.

2. If necessary, you can add new tools or modify existing Google Drive tools. Use Connector Studio to create custom tools for specialized workflows or to modify existing tools to change parameters, add validation logic, or adjust response formats to match your agent's needs.

3. Configure the authentication type (individual or shared). Choose individual auth when each user needs to connect their own Google Drive account, or shared auth when your agent should act on behalf of a single service account across all users. 

4. Bundle tools into Tool Packs and associate them with your agent via the dashboard or API. Group related Google Drive tools into a Tool Pack (e.g., "Document Management" or "File Storage Core"), then attach that Tool Pack to your agent through the Agent Handler dashboard or programmatically via the API. This makes it easy to manage permissions and enable/disable entire sets of functionality at once.

Explore other MCP servers built and managed by Merge

airtable
Airtable
asana
Asana
calendly
Calendly
confluence
Confluence
figma
Figma
github
GitHub
gmail
Gmail
gong
Gong
google_calendar
Google Calendar
greenhouse
Greenhouse
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
linear
Linear
microsoft_teams
Microsoft Teams
notion
Notion
onedrive
OneDrive
outlook
Outlook
pipedrive
Pipedrive
quickbooks_online
QuickBooks Online
sapsf
SAP SuccessFactors
salesforce
Salesforce
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
slack
Slack
stripe
Stripe
weather
Weather
wikipedia
Wikipedia
zendesk
Zendesk
zoom
Zoom

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now