📧 Gmail MCP Server

A simple and powerful Model Context Protocol (MCP) server that integrates Gmail with Claude AI using App Password — no complex OAuth setup needed!

✨ Features

• 📤 Send Emails — Send emails to anyone directly from Claude
• 🔐 App Password Auth — Simple setup, no OAuth required
• 🐳 Docker Support — Run anywhere with Docker
• ⚡ npx Support — No installation needed

🔑 Step 1 — Get Gmail App Password

App Passwords are special passwords that let apps access your Gmail securely.

1. Go to your Google Account
2. Click "Security" on the left
3. Enable 2-Step Verification (required for App Passwords)
4. Go back to Security → scroll down → click "App Passwords"
5. Select "Mail" and "Windows Computer" (or any device)
6. Click "Generate"
7. Copy the 16-character password shown (e.g. zfuy wpew zrde nmij)

🚀 Step 2 — Choose your setup method

Option A — Using npx (easiest) ✅

Only requires Node.js — no installation needed!

Open your Claude Desktop config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "gmail-app-password-mcp"],
      "env": {
        "GMAIL_USER": "[email protected]",
        "GMAIL_APP_PASSWORD": "your-16-char-app-password"
      }
    }
  }
}

Restart Claude Desktop and you're done! ✅

Option B — Using Docker 🐳

No Node.js or npm needed — just Docker!

Step 1 — Install Docker Desktop Download from 👉 https://www.docker.com/products/docker-desktop

Step 2 — Pull the image

docker pull paras7409/gmail-app-password-mcp

Step 3 — Run the server

Windows (PowerShell):

docker run -p 3000:3000 -e [email protected] -e GMAIL_APP_PASSWORD=your-app-password -e TRANSPORT=http paras7409/gmail-app-password-mcp

Mac / Linux:

docker run -p 3000:3000 \
  -e [email protected] \
  -e GMAIL_APP_PASSWORD=your-app-password \
  -e TRANSPORT=http \
  paras7409/gmail-app-password-mcp

You should see:

Gmail MCP server running at http://localhost:3000/mcp

Step 4 — Add to Claude Desktop config

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "gmail-app-password-mcp"],
      "env": {
        "GMAIL_USER": "[email protected]",
        "GMAIL_APP_PASSWORD": "your-16-char-app-password"
      }
    }
  }
}

Step 5 — Restart Claude Desktop ✅

Which option should I choose?

| | npx | Docker | |---|---|---| | Requires Node.js | ✅ Yes | ❌ No | | Requires Docker | ❌ No | ✅ Yes | | Easiest for developers | ⭐ | | | Easiest for non-developers | | ⭐ |

💬 Usage Examples

Once set up, just talk to Claude naturally:

"Send an email to [email protected] about tomorrow's meeting"

"Email my team at [email protected] that the project is complete"

"Send a follow up email to [email protected] regarding our last conversation"

🔧 Environment Variables

| Variable | Description | Example | |---|---|---| | GMAIL_USER | Your Gmail address | [email protected] | | GMAIL_APP_PASSWORD | Your 16-char App Password | zfuy wpew zrde nmij | | TRANSPORT | Transport mode | stdio (default) or http | | PORT | Port for HTTP mode | 3000 (default) |

🛡️ Security

• Credentials are passed via environment variables — never hardcoded
• App Passwords can be revoked anytime from your Google Account
• No credentials are stored or logged by the server

🔗 Links

• 📦 npm: https://www.npmjs.com/package/gmail-app-password-mcp
• 🐳 Docker: https://hub.docker.com/r/paras7409/gmail-app-password-mcp
• 💻 GitHub: https://github.com/Paras1Chauhan/gmail-mcp-server

🤝 Contributing

Contributions are welcome! Feel free to open a Pull Request or Issue.

📄 License

ISC © paras0511