Google Sheets MCP Server

What is Google Sheets MCP Server?

A Model Context Protocol (MCP) server that enables Claude Desktop to interact with Google Sheets directly. It provides tools for creating, reading, writing, and managing Google Sheets through Claude Desktop.

How to use Google Sheets MCP Server?

Install Python 3.10+, set up a virtual environment, install dependencies with uv, and configure Google Cloud OAuth 2.0 credentials. Then add the server to Claude Desktop’s claude_desktop_config.json with the path to the Python interpreter and the credentials file. Run the server manually once to complete browser-based OAuth authentication; the token is saved automatically. After setup, use commands like create_sheet, format_range, or write_formula directly in Claude Desktop.

Key features of Google Sheets MCP Server

• Create new Google Sheets
• Read and write data to existing sheets
• Format cells and ranges
• Add and delete sheets
• Write formulas
• Search for sheets
• List available sheets

Use cases of Google Sheets MCP Server

• Automate spreadsheet creation and data entry via conversation
• Format ranges and apply formulas without leaving Claude Desktop
• Manage multiple sheets (add/delete) through natural language
• Quickly look up or list existing Google Sheets

FAQ from Google Sheets MCP Server

What are the prerequisites?

Python 3.10 or higher, a Google Cloud Project with the Sheets API and Drive API enabled, OAuth 2.0 credentials, and the uv package manager. Claude Desktop is also required.

How do I set up OAuth authentication?

Download OAuth 2.0 credentials from the Google Cloud Console as a JSON file and save it to ~/.config/google_sheets_mcp/google-sheets-mcp.json. The first server run will open a browser to authorize the application; the resulting token is saved automatically.

What tools/commands are available?

Tools include create_sheet, format_range, write_formula, add_sheet, delete_sheet, and get_sheet_properties.

How do I troubleshoot authentication issues?

Ensure the OAuth credentials file is valid, that your email is added as a test user in the Google Cloud project, and try deleting token.json and re‑authenticating.

What if the server won’t connect?

Check that the server is running, verify the credentials path in the Claude Desktop configuration, and review logs in Claude Desktop for error messages.