A favicon of Gmail GAS

Gmail GAS

Model Context Protocol server for Gmail integration using Google Apps Script.

Installation

Installing for Claude Desktop

Option 1: One-Command Installation

npx mcpbar@latest install kazuph/mcp-gmail-gas -c claude

This command will automatically install and configure the Gmail GAS MCP server for your selected client.

Option 2: Manual Configuration

Run the command below to open your configuration file:

npx mcpbar@latest edit -c claude

After opening your configuration file, copy and paste this configuration:

View JSON configuration
{
  "mcpServers": {
    "Gmail GAS": {
      "command": "npx",
      "args": [
        "-y",
        "@kazuph/mcp-gmail-gas"
      ],
      "env": {
        "YOUR_DEPLOYMENT_URL": "${input:your_deployment_url}",
        "VALID_API_KEY": "${input:valid_api_key}",
        "YOUR_API_KEY": "${input:your_api_key}"
      }
    }
  }
}

MCP Gmail

Model Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.

@kazuph/mcp-gmail-gas MCP server

Quick Start (For Users)

Prerequisites

  • Node.js 18+ (install via brew install node)
  • Gmail account
  • Google Apps Script deployment
  • Claude Desktop (install from https://claude.ai/desktop)

Configuration

  1. Deploy the Google Apps Script
  • Visit Google Apps Script and create a new project
  • Copy the entire contents of code.gs and paste it into the script editor
  • Click on "Deploy" > "New deployment"
  • Select "Web app" as the deployment type
  • Configure the following settings:
    • Execute as: Me
    • Who has access: Anyone
    • Click "Deploy"
  • When prompted, review and authorize the app to access your Gmail account
  • Copy the deployment URL and generate a random API key for security

Note: The script requires Gmail access permissions. When you first deploy and run the script, Google will ask you to review and grant these permissions. Make sure to:

  1. Click "Review Permissions"

  2. Select your Google account

  3. Click "Advanced" if you see a warning

  4. Click "Go to [Your Project Name] (unsafe)"

  5. Click "Allow" to grant the necessary Gmail permissions

  6. Open your Claude Desktop configuration file at: ~/Library/Application Support/Claude/claude_desktop_config.json

You can find this through the Claude Desktop menu:

  1. Open Claude Desktop

  2. Click Claude on the Mac menu bar

  3. Click "Settings"

  4. Click "Developer"

  5. Add the following to your configuration:

{
  "tools": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-gmail-gas"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Note: Replace YOUR_DEPLOYMENT_URL and YOUR_API_KEY with your actual values.

For Developers

Prerequisites

  • Node.js 18+ (install via brew install node)
  • Gmail account
  • Google Apps Script
  • Claude Desktop (install from https://claude.ai/desktop)
  • tsx (install via npm install -g tsx)

Installation

git clone https://github.com/kazuph/mcp-gmail-gas.git
cd mcp-gmail-gas
npm install
npm run build

Development Configuration

  1. Make sure Claude Desktop is installed and running.

  2. Install tsx globally if you haven't:

npm install -g tsx
# or
pnpm add -g tsx
  1. Modify your Claude Desktop config located at: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the following to your MCP client's configuration:

{
  "tools": {
    "gmail": {
      "args": ["tsx", "/path/to/mcp-gmail-gas/index.ts"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Available Tools

  • gmail_search_messages: Search for emails using Gmail search query syntax (e.g., "subject:Meeting newer_than:1d")
  • gmail_get_message: Get the full content and details of a specific email
  • gmail_download_attachment: Download an attachment from a specific email

Security Note

Always keep your VALID_API_KEY secret and never commit it to version control. This key helps ensure that only authorized clients can access your Gmail through the Google Apps Script deployment.

Share:
Details:
  • Stars


    10
  • Forks


    6
  • Last commit


    7 months ago
  • Repository age


    7 months
  • License


    MIT
View Repository

Auto-fetched from GitHub .

MCP servers similar to Gmail GAS:

 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


Gmail GAS: MCP Server – MCP.Bar