Gmail MCP Server

MCP server for Gmail that lets AI agents read, search, draft, and send email, manage labels, and organize the inbox via the Gmail API with OAuth. Handy for triaging mail, drafting replies, and automating routine inbox workflows from an AI client.

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@gongrzhe/server-gmail-autoauth-mcp"
      ],
      "env": {
        "GMAIL_OAUTH_CREDENTIALS": "<YOUR_GMAIL_OAUTH_CREDENTIALS>"
      }
    }
  }
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Gmail search query (e.g., \"from:boss is:unread\")"
    },
    "max_results": {
      "type": "integer",
      "description": "Maximum number of messages to return"
    }
  }
}

{
  "type": "object",
  "required": [
    "to",
    "subject",
    "body"
  ],
  "properties": {
    "to": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Recipient email addresses"
    },
    "body": {
      "type": "string",
      "description": "Email body"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    }
  }
}

{
  "type": "object",
  "required": [
    "to",
    "subject",
    "body"
  ],
  "properties": {
    "to": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Recipient email addresses"
    },
    "body": {
      "type": "string",
      "description": "Email body"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    }
  }
}