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"