Google Toolbox
MCP server for google toolbox
What is Google Toolbox?
Google Toolbox is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for google toolbox
MCP server for google toolbox
This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for google toolbox
Use Cases
Maintainer
Works with
Installation
NPM
npx -y google-toolboxManual Installation
npx -y google-toolboxConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Google Toolbox
The Google Toolbox MCP server (py-mcp-google-toolbox) integrates Gmail, Google Calendar, Google Drive, and Google Custom Search into a single MCP server. It exposes tools for reading and sending email, managing calendar events, reading and searching Drive files, and performing Google web searches — all accessible from any MCP-compatible AI client.
Prerequisites
- Python 3.12 installed
- uv package manager (curl -LsSf https://astral.sh/uv/install.sh | sh)
- A Google Cloud project with Gmail, Calendar, Drive, and Custom Search APIs enabled
- OAuth 2.0 credentials file (credentials.json) downloaded from Google Cloud Console
- Google API Key and Custom Search Engine ID for web search
Clone the repository and set up the environment
Clone the repository and use uv to create a Python 3.12 virtual environment, then install dependencies.
git clone https://github.com/jikime/py-mcp-google-toolbox.git
cd py-mcp-google-toolbox
uv venv -p 3.12
source .venv/bin/activate
uv pip install -r requirements.txtConfigure environment variables
Create a .env file in the project root with your Google API credentials. Place credentials.json from the Google Cloud Console in the project directory.
GOOGLE_API_KEY=your_google_api_key
GOOGLE_CSE_ID=your_custom_search_engine_id
GOOGLE_CLIENT_ID=your_oauth_client_id
GOOGLE_CLIENT_SECRET=your_oauth_client_secret
GOOGLE_REFRESH_TOKEN=your_refresh_tokenObtain a refresh token
Run the included helper script to complete the OAuth flow and generate your GOOGLE_REFRESH_TOKEN. This opens a browser window for authorization.
uv run get_refresh_token.pyTest the server locally
Start the MCP server in development mode to verify tools are listed and credentials are working.
mcp dev server.pyAdd the server to Claude Desktop config
Register the server in your Claude Desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json.
{
"mcpServers": {
"google-toolbox": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/py-mcp-google-toolbox",
"run",
"server.py"
],
"env": {
"GOOGLE_API_KEY": "your_google_api_key",
"GOOGLE_CSE_ID": "your_cse_id",
"GOOGLE_CLIENT_ID": "your_client_id",
"GOOGLE_CLIENT_SECRET": "your_client_secret",
"GOOGLE_REFRESH_TOKEN": "your_refresh_token"
}
}
}
}Google Toolbox Examples
Client configuration
Complete claude_desktop_config.json entry for the Google Toolbox MCP server using uv.
{
"mcpServers": {
"google-toolbox": {
"command": "uv",
"args": [
"--directory",
"/Users/yourname/py-mcp-google-toolbox",
"run",
"server.py"
],
"env": {
"GOOGLE_API_KEY": "your_google_api_key",
"GOOGLE_CSE_ID": "your_cse_id",
"GOOGLE_CLIENT_ID": "your_client_id",
"GOOGLE_CLIENT_SECRET": "your_client_secret",
"GOOGLE_REFRESH_TOKEN": "your_refresh_token"
}
}
}
}Prompts to try
Example natural language prompts to use with the Google Toolbox MCP server once configured.
- "Show me my 5 most recent unread emails"
- "Search my emails for messages from [email protected]"
- "Send an email to [email protected] with subject 'Meeting notes' and the body attached"
- "List my Google Calendar events for tomorrow"
- "Create a calendar event called 'Team standup' tomorrow at 10am for 30 minutes"
- "Search my Google Drive for files containing 'Q4 report'"
- "Search the web for 'Model Context Protocol best practices'"Troubleshooting Google Toolbox
credentials.json not found or OAuth flow fails
Download the OAuth 2.0 Client ID credentials as a JSON file from Google Cloud Console (APIs & Services > Credentials) and save it as credentials.json in the project root directory. Ensure the app has the correct scopes enabled for Gmail, Calendar, and Drive.
GOOGLE_CSE_ID or search returns no results
Create a Programmable Search Engine at https://programmablesearchengine.google.com and set it to search the entire web. Copy the Search Engine ID to GOOGLE_CSE_ID and ensure the Google Custom Search JSON API is enabled in your Cloud project.
Token expired or invalid_grant error
Re-run uv run get_refresh_token.py to complete the OAuth flow and obtain a new refresh token. Update GOOGLE_REFRESH_TOKEN in your .env file and restart the MCP server.
Frequently Asked Questions about Google Toolbox
What is Google Toolbox?
Google Toolbox is a Model Context Protocol (MCP) server that mcp server for google toolbox It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Google Toolbox?
Install via npm with the command: npx -y google-toolbox. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Google Toolbox?
Google Toolbox works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Google Toolbox free to use?
Yes, Google Toolbox is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Google Toolbox Alternatives — Similar APIs Servers
Looking for alternatives to Google Toolbox? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
★ 43.4k🦍 The API and AI Gateway
API Mega List
★ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪
Fetch
★ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
★ 2.1kSelf-Hosted API Management for Builders
Korean Law
★ 1.8k국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools
RuleGo
★ 1.5k⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
Browse More APIs MCP Servers
Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Google Toolbox in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Google Toolbox?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.