1. Navigate to Google Cloud Console;
2. Create a new project or select an existing one;
3. Enter project name (e.g., "gmail mcp agent");
4. Accept suggested organization and location settings;
5. Click Create and wait for project initialization.

1. From the side menu, go to "APIs & Services" → "Library";
2. Search for "Gmail API";
3. Select the first result and click "Enable";
4. This grants your project permission to access Gmail functionality.

1. Navigate to the "Credentials" tab;
2. If prompted, click "Configure consent screen";
3. Click "Get started";
4. Enter application name (e.g., "gmail agent");
5. Input your email address;
6. Select "External Audience" for user type, if you use general Gmail account;
7. Re-enter your email address when prompted;
8. Accept the user data policy;
9. Click Continue and Create.

1. Click "Create OAuth Client";
2. Select "Web Application";
3. Accept the suggested name or customize;
4. Click "Add URI";
5. Enter the redirect URI: http://localhost:3000/oauth2callback;
6. Click the blue Create button;
7. Download the JSON credentials file;
8. Rename the file to: gsp-oauth.keys.json.

Navigate to your root/home directory:

• Mac: Home folder Users/user_nameor Windows: C:\Users\Your_Username\;
• Use Command + Shift + . (Mac) or Ctrl + Shift + . (Windows) to show hidden files;
• Create a new folder named: .gmail-mcp;
• Move the gsp-oauth.keys.json file into this folder;
• Use Command + Shift + . again to hide folders.

The server is configured to automatically locate credentials in this directory.

• Open Claude with Desktop Commander MCP installed. For quick setup, use Smithery command;
• In a new Claude chat, type the prompt:

run npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude

• During execution, Claude asks permission to use Desktop Commander MCP. Click Allow always or Allow once;
• You'll be redirected to a Google Auth page. Select the same email used for the Cloud project. Click Allow to grant Gmail access. Wait for the Success message;
• Restart Claude Desktop. The new server should now show as connected.

• Copy the prompt and paste to Claude new or alredy opened chat:

add next config block to claude config file
{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Run the prompt → Claude will update the config file.
• Confirm the block was added correctly (Optional). Go to Settings (shortcut: Cmd + ,) → Developer → Edit Config → open claude_desktop_config.json file in text editor;
• Completely close and reopen Claude Desktop.

Update Configuration File

• In Claude Desktop, press Command + , (Mac) or Ctrl + , (Windows);
• Click "Edit Config";
• Open the configuration file in a text editor;
• Copy the configuration block;

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    },
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Paste it into your Claude config file after previous configuration block and before two last closing curly brackets;
• Save the file (Command/Ctrl + S);
• Completely close and reopen Claude Desktop.