Connect your AI Agents to Google Sheets in minutes

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

Available tools

add_sheet

Add a new sheet (tab) to an existing spreadsheet with customizable properties.

delete_sheet

Permanently delete a sheet (tab) from a spreadsheet. Cannot be undone.

update_sheet_properties

Update sheet properties like title, position, visibility, or tab color.

copy_sheet

Copy a sheet within the same spreadsheet or to a different spreadsheet.

sort_range

Sorts data in rows based on a sort order per column. Supports multi-column sorting and color-based sorting.

set_data_validation

Sets data validation rules to cells in a range. Supports number, text, date validation, dropdown lists, and custom rules. Use empty rule to clear validation.

set_basic_filter

Sets a basic filter on a sheet with optional sorting and column-specific filter criteria. Supports text, number, and date filtering.

create_spreadsheet

Create a new spreadsheet with specified title and optional properties.

get_spreadsheet

Retrieve spreadsheet information including metadata, sheets, and optionally cell data.

update_spreadsheet_properties

Update spreadsheet properties such as title, locale, or timezone.

get_values

Read cell values from a specified range using A1 notation (e.g., 'Sheet1!A1:B10').

update_values

Write cell values to a specified range. Supports formulas and raw values.

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 Sheets  MCP server

FAQs on using Merge's Google Sheets  MCP server

What is a Google Sheets MCP server?

It’s an MCP server that exposes data and functionality from Google Sheets via tools. Your agents can invoke these tools to add sheets, sort data in a row within a sheet, copy a sheet to a new spreadsheet, and more.

How can I use the Google Sheets MCP server?

Here are some common use cases:

  • Automated reporting and dashboards: Your agent can pull data from various sources and automatically populate Google Sheets reports with the latest metrics. For example, when weekly sales data is updated in your CRM, your agent can calculate totals, generate trend analyses, and update your executive dashboard spreadsheet with formatted charts and insights 
  • Data validation and cleanup: Your agent can scan your spreadsheets for inconsistencies, duplicates, or formatting errors and automatically correct them. For instance, when new contact information is added to your lead tracking sheet, your agent can validate email formats, standardize phone number formatting, and flag duplicate entries for review
  • Cross-system data synchronization: Your agent can keep data synchronized between Google Sheets and other tools in your workflow. For example, when a task status changes in your project management sheet, your agent can update the corresponding record in your project management platform and notify relevant team members via Slack 
  • Budget tracking and alerts: Your agent can monitor spending across your budget sheets and trigger alerts when thresholds are reached. For instance, when department expenses approach 80% of their quarterly budget, your agent can notify finance managers, create a summary of top spending categories, and suggest areas for cost optimization based on historical patterns

What are popular tools for Google Sheets’ MCP server?

Here are some popular tools across data types:

Sheets

  • <code class="blog_inline-code">copy_sheet</code>
  • <code class="blog_inline-code">delete_sheet</code>
  • <code class="blog_inline-code">add_sheet</code>

Cell values 

  • <code class="blog_inline-code">get_values</code>
  • <code class="blog_inline-code">batch_get_values</code>
  • <code class="blog_inline-code">append_values</code>
  • <code class="blog_inline-code">clear_values</code>

Spreadsheets

  • <code class="blog_inline-code">create_spreadsheet</code>
  • <code class="blog_inline-code">get_spreadsheet</code>
  • <code class="blog_inline-code">update_spreadsheet_properties</code>

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

Merge Agent Handler provides platform-level capabilities that apply to all connectors, including Google Sheets:

  • Enterprise-grade security and DLP: Tool inputs and outputs are scanned for sensitive data, with rules to block, redact, or mask content before execution or return
  • Authentication and credential management: Supports guided user authentication flows and manages credentials on behalf of your agents
  • Tool Pack management: Lets you bundle connectors and tools into Tool Packs and control which agents and users can access them
  • Real-time observability and audit trails: Every tool call is logged, with fully-searchable logs to audit, debug, and optimize agent behavior 

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

Yes, Merge Agent Handler allows you to configure custom data loss prevention (DLP) rules for Google Sheets tool calls. 

Here are examples of security rules you can set:

  • Sensitive data redaction: Block or redact tool calls that attempt to read or write sensitive information (e.g., social security numbers). For example, if your agent tries to update a cell with a value matching a credit card pattern, the rule can automatically redact the numbers or block the operation entirely
  • External sharing restrictions: Prevent your agent from sharing spreadsheets with email addresses outside your approved domains. For instance, you can block any share_spreadsheet tool calls that attempt to grant access to recipients not on your organization's allow list
  • Password and credential protection: Automatically detect and block tool calls that attempt to write passwords, authentication tokens, or other credentials into spreadsheet cells. For example, if your agent tries to log API keys or database passwords in a tracking sheet, the security rule can intercept and block the write operation
  • PII masking: Configure rules to mask personally identifiable information when your agent reads from sheets containing customer data. For instance, when your agent retrieves employee information from an HR spreadsheet, phone numbers and addresses can be automatically masked while still allowing the agent to process other fields like department and role

How can I start using Merge Agent Handler’s Google Sheets MCP server?

You can follow these steps:

1. Create your Agent Handler account. Sign up for a free account here.

2. Create a Tool Pack. Navigate to "Tool Packs" in the left sidebar and click "Create New Tool Pack." Give it a descriptive name (e.g., "Google Sheets Automation Pack").

3. Add the Google Sheets connector. Browse the available connectors and add Google Sheets to your Tool Pack.

4. Configure authentication. Choose your authentication method:

  • Individual authentication: Each user connects their own Google Sheets account
  • Shared authentication: Use one set of organization-level credentials for all users

5. Select specific tools. Choose which Google Sheets tools you want to make available to your agent, or enable all tools by default.

6. Register a User. Navigate to "Registered Users" in the sidebar and create a new registered user. This represents the identity that will perform actions through your agent.

7. Save your Tool Pack. Review and save all your Tool Pack settings.

8. Connect to your agent or IDE. Copy the MCP entry URL from your Tool Pack settings. The URL format will be: https://ah-api.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp. Then add it to your IDE configuration (Cursor, Windsurf, Claude Desktop, or Visual Studio Code) using the authentication token provided.

Explore other MCP servers built and managed by Merge

activecampaign
ActiveCampaign
airtable
Airtable
amazon_s3
Amazon S3
anaplan
Anaplan
apollo
Apollo
articulate
Articulate Reach 360
asana
Asana
bamboohr
BambooHR
basecamp
Basecamp
bitbucket
Bitbucket
box
Box
cms_coverage
CMS Coverage
calendly
Calendly
canva
Canva
clickup
ClickUp
clinicaltrials
ClinicalTrials.gov
cloudflare
Cloudflare
confluence
Confluence
contentful
Contentful
databricks
Databricks
datadog
Datadog
docusign
DocuSign
dropbox
Dropbox
dynamics365
Dynamics 365 Sales
exa
Exa
expensify
Expensify
factset
FactSet
figma
Figma
firecrawl
Firecrawl
freshbooks
FreshBooks
freshdesk
Freshdesk
freshservice
Freshservice
front
Front
gamma
Gamma
github
GitHub
gitlab
GitLab
gmail
Gmail
gong
Gong
google_bigquery
Google BigQuery
google_calendar
Google Calendar
google_docs
Google Docs
google_drive
Google Drive
google_meet
Google Meet
google_slides
Google Slides
greenhouse
Greenhouse
hibob
HiBob
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
linear
Linear
linkedin
LinkedIn
make
Make
microsoft_teams
Microsoft Teams
miro
Miro
monday
Monday.com
npi_registry
NPI Registry
notion
Notion
onedrive
OneDrive
onenote
OneNote
oracle_hcm
Oracle HCM
outlook
Outlook
paypal
PayPal
pipedrive
Pipedrive
pubmed
PubMed
pylon
Pylon
quartr
Quartr
quickbooks_online
QuickBooks Online
ramp
Ramp
rootly
Rootly
sapsf
SAP SuccessFactors
salesforce
Salesforce
sendgrid
SendGrid
sentry
Sentry
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
slack
Slack
snowflake
Snowflake
square
Square
straker
Straker
stripe
Stripe
teamwork
Teamwork.com
trello
Trello
visualping
VisualPing
weather
Weather
wikipedia
Wikipedia
workday
Workday
x
X
zendesk
Zendesk
zendesk_sell
Zendesk Sell
zohocrm
Zoho CRM
zohodesk
Zoho Desk
zoom
Zoom
zoominfo
ZoomInfo
biorxiv
bioRxiv
n8n
n8n

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