Install this MCP

Pick your client, then copy the config.

Install config
{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

Set up with your agent

Uses the same client as above (Cursor). Paste into that agent.

Agent prompt
Install the "Gmail MCP" MCP for Cursor in this workspace.
1. Read official install docs: https://github.com/gmail-mcp-server
2. Merge this JSON into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

3. Required environment variables / secrets (ask the user; never invent secrets):
   - GMAIL_OAUTH_PATH (required): See repository README.
   - GMAIL_CREDENTIALS_PATH (required): See repository README.
   - OPENAI_API_KEY (required): See repository README.
4. Restart Cursor if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/gmail.html

Try it

After install, paste one of these into your agent.

  • Read and search emails from AI
  • Compose and send drafts
  • Manage labels and filters