Connect your AI Agents to Google Drive in minutes

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}
11Open 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}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 }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}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








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
