Google MCP Server

MCP server for connecting Claude Desktop to Google Mail, Docs, Sheets, and Tasks.

Setup

1. Google Cloud Console Setup

1. Go to Google Cloud Console

2. Create a new project (or select existing)

3. Enable these APIs (APIs & Services → Library):

   • Gmail API

   • Google Docs API

   • Google Sheets API

   • Google Tasks API

4. Configure OAuth Consent Screen:

   • Go to APIs & Services → OAuth consent screen

   • Select "External" user type

   • Fill in app name and your email

   • Add scopes: gmail.modify, documents, spreadsheets, tasks

   • Add your email as a test user

5. Create OAuth Credentials:

   • Go to APIs & Services → Credentials

   • Click "Create Credentials" → "OAuth client ID"

   • Select "Desktop app" as application type

   • Download the JSON file

2. Install and Configure

# Install dependencies
npm install

# Build the project
npm run build

# Create config directory and save credentials
mkdir -p ~/.google-mcp
# Save your downloaded credentials.json to ~/.google-mcp/credentials.json

# Authenticate with Google
npm run auth

3. Claude Desktop Configuration

Windows with WSL

Add to your Claude Desktop config (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "google": {
      "command": "wsl",
      "args": [
        "/path/to/node",
        "/path/to/google-mcp-server/dist/index.js"
      ]
    }
  }
}

Note: Use full path to node (run which node in WSL to find it), e.g., /home/user/.nvm/versions/node/v22.21.1/bin/node

Linux

Add to ~/.config/claude-desktop/claude_desktop_config.json:

{
  "mcpServers": {
    "google": {
      "command": "node",
      "args": [
        "/path/to/google-mcp-server/dist/index.js"
      ]
    }
  }
}

macOS

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "google": {
      "command": "node",
      "args": ["/path/to/google-mcp-server/dist/index.js"]
    }
  }
}

Available Tools

Gmail

• gmail_search - Search emails with Gmail query syntax

• gmail_read - Read a specific email by ID

• gmail_send - Send an email

Google Docs

• docs_get - Get document content

• docs_create - Create a new document

• docs_append - Append text to a document

Google Sheets

• sheets_read - Read data from a range

• sheets_write - Write data to a range

• sheets_create - Create a new spreadsheet

Google Tasks

• tasks_list - List task lists or tasks

• tasks_create - Create a new task

• tasks_update - Update/complete a task

Usage Examples

After setup, you can ask Claude Desktop to:

• "Search my emails for messages from john@example.com"

• "Read my latest unread emails"

• "Create a new Google Doc called 'Meeting Notes'"

• "Read the data from my spreadsheet"

• "Show me my task lists"

• "Create a task to call dentist tomorrow"