Google MCP Server

A Model Context Protocol (MCP) server that integrates with Google APIs (Calendar, Drive, Gmail, Sheets, Docs) to provide seamless access to Google services through MCP-compatible clients.

Features

• Multiple Account Support: Manage multiple Google accounts with automatic context-aware selection
• Multi-Service Support: Integrated support for Google Calendar, Drive, Gmail, Sheets, and Docs
• OAuth 2.0 Authentication: Secure authentication with automatic token refresh
• MCP Protocol Compliant: Fully compliant with the Model Context Protocol specification
• Cross-Platform: Works on Windows, macOS, and Linux
• Configurable: Flexible configuration through JSON files or environment variables

Quick Start

macOS Quick Setup (Recommended)

# Install via Homebrew
brew tap ngs/tap
brew install google-mcp-server

# Configure Claude Desktop (Apple Silicon)
echo '{
  "mcpServers": {
    "google": {
      "command": "/opt/homebrew/bin/google-mcp-server"
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Run to authenticate (first time only)
google-mcp-server

For detailed setup instructions, see below.

Prerequisites

1. Google Cloud Project with APIs enabled
2. OAuth 2.0 credentials from Google Cloud Console
3. Go 1.23 or later (only for building from source)

Installation

Using Homebrew (macOS/Linux)

brew tap ngs/tap
brew install google-mcp-server

From Source

git clone https://github.com/ngs/google-mcp-server.git
cd google-mcp-server
go build

Using Go Install

go install go.ngs.io/google-mcp-server@latest

Pre-built Binaries

Download pre-built binaries from the releases page for:

• macOS (Intel & Apple Silicon)
• Linux (x86_64 & ARM64)
• Windows (x86_64)

Setup

1. Create a Google Cloud Project

   • Go to Google Cloud Console
   • Create a new project or select an existing one
   • Enable the required APIs:
     • Google Calendar API
     • Google Drive API
     • Gmail API
     • Google Sheets API
     • Google Docs API
     • Google Slides API

2. Create OAuth 2.0 Credentials

   • In Google Cloud Console, go to "APIs & Services" > "Credentials"
   • Click "Create Credentials" > "OAuth client ID"
   • Choose "Desktop app" as the application type
   • Download the credentials JSON file

3. Configure the Server

   Create a config.json file:

   {
     "oauth": {
       "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
       "client_secret": "YOUR_CLIENT_SECRET",
       "redirect_uri": "http://localhost:8080/callback"
     },
     "services": {
       "calendar": {"enabled": true},
       "drive": {"enabled": true},
       "gmail": {"enabled": true},
       "sheets": {"enabled": true},
       "docs": {"enabled": true},
       "slides": {"enabled": true}
     }
   }
   

   Or use environment variables:

   export GOOGLE_CLIENT_ID="YOUR_CLIENT_ID.apps.googleusercontent.com"
   export GOOGLE_CLIENT_SECRET="YOUR_CLIENT_SECRET"
   

4. Run the Server

   ./google-mcp-server
   

   On first run, it will open a browser for authentication. Grant the requested permissions to proceed.

Available Tools

Account Management

• accounts_list - List all authenticated Google accounts
• accounts_details - Get detailed information about accounts
• accounts_add - Add a new Google account
• accounts_remove - Remove an authenticated account
• accounts_refresh - Refresh authentication token for an account

Google Calendar

• calendar_list - List all accessible calendars
• calendar_events_list - List events with date range filtering (supports account parameter)
• calendar_events_list_all_accounts - List events from all authenticated accounts
• calendar_event_create - Create new events (supports account p

... View full README on GitHub