Shamp Mail

////////////////////////////////////////////////////////////////////////////////
//                                                                            //
//  ░██████╗██╗░░██╗░█████╗░███╗░░░███╗██████╗░███╗░░░███╗░█████╗░██╗██╗   //
//  ██╔════╝██║░░██║██╔══██╗████╗░████║██╔══██╗████╗░████║██╔══██╗██║██║   //
//  ╚█████╗░███████║███████║██╔████╔██║██████╔╝██╔████╔██║███████║██║██║   //
//  ░╚═══██╗██╔══██║██╔══██║██║╚██╔╝██║██╔═══╝░██║╚██╔╝██║██╔══██║██║██║   //
//  ██████╔╝██║░░██║██║░░██║██║░╚═╝░██║██║░░░░░██║░╚═╝░██║██║░░██║██║██║   //
//  ╚═════╝░╚═╝░░╚═╝╚═╝░░╚═╝╚═╝░░░░╚═╝╚═╝░░░░░╚═╝░░░░░╚═╝╚═╝░░╚═╝╚═╝╚═╝   //
//                                                                            //
//                  [ Gmail Send-Only MCP Server v1.0.0 ]                    //
//                                                                            //
////////////////////////////////////////////////////////////////////////////////

 ╔══════════════════════════════════════════════════════════════════════════╗
 ║  RLS  DATE  :  2026                                                      ║
 ║  RLS  TYPE  :  MCP Server / Gmail Integration                            ║
 ║  LANGUAGE   :  Node.js (CommonJS)                                        ║
 ║  RUNTIME    :  Node.js v18+                                              ║
 ║  PROTECTION :  OAuth2 / Google Identity Platform                         ║
 ║  FILES      :  server.js / auth.js / package.json                        ║
 ╚══════════════════════════════════════════════════════════════════════════╝

 ┌──────────────────────────────────────────────────────────────────────────┐
 │  :: RELEASE NOTES                                                        │
 └──────────────────────────────────────────────────────────────────────────┘

   ShampMail is a lean, send-only MCP (Model Context Protocol) server that
   wires Claude Desktop directly to Gmail via OAuth2. No inbox access.
   No read permissions. No bloat. Drop it in, run auth once, and Claude
   can send emails on your behalf from that point forward.

   Communicates over stdio transport. Must be running before Claude Desktop
   starts. That's it.

 ┌──────────────────────────────────────────────────────────────────────────┐
 │  :: REQUIREMENTS                                                         │
 └──────────────────────────────────────────────────────────────────────────┘

   [x]  Node.js v18 or higher
   [x]  A Google Cloud project with Gmail API enabled
   [x]  OAuth2 Desktop App credentials  (credentials.json)
   [x]  Claude Desktop

 ┌──────────────────────────────────────────────────────────────────────────┐
 │  :: INSTALL                                                              │
 └──────────────────────────────────────────────────────────────────────────┘

   01.  Clone the repo to a local directory
        e.g.  C:\MCP_Servers\ShampMail\

   02.  Go to console.cloud.google.com
        Enable the Gmail API on your project
        Create OAuth2 credentials  (type: Desktop App)
        Download and save as  credentials.json  in the project folder

   03.  Install dependencies

          npm install

   04.  Run the auth script ONE TIME to generate token.json

          node auth.js

        Open the printed URL in your browser
        Sign in and grant Gmail send permission
        token.json is written automatically — you will not need to repeat this

   05.  Start the server

          node server.js

        Server must be running BEFORE launching Claude Desktop

 ┌──────────────────────────────────────────────────────────────────────────┐
 │  :: CLAUDE DESKTOP INTEGRATION                                           │
 └──────────────────────────────────────────────────────────────────────────┘

   Edit your Claude Desktop config file:

     C:\Users\\AppData\Roaming\Claude\claude_desktop_config.json

   Add the following block:

     {
       "mcpServers": {
         "ShampMail": {
           "command": "node",
           "args": ["C:\\MCP_Servers\\ShampMail\\server.js"]
         }
       }
     }

   Restart Claude Desktop. The  gmail_send  tool will be available immediately.

 ┌──────────────────────────────────────────────────────────────────────────┐
 │  :: TOOL PARAMETERS                                                      │
 └──────────────────────────────────────────────────────────────────────────┘

   PARAM        REQUIRED    DESCRIPTION
   ─────────    ────────    ─────────────────────────────────────────────
   to           YES         Recipient address(es), comma-separated
   subject      YES         Email subject line
   body         YES         Plain-text email body
   cc           no          CC recipients, comma-separated
   bcc          no          BCC recipients, comma-separated

 ┌──────────────────────────────────────────────────────────────────────────┐
 │  :: KNOWN ISSUES / NUKES                                                 │
 └──────────────────────────────────────────────────────────────────────────┘

   [!]  Server MUST be running before Claude Desktop launches
        or the tool will not register in the session

   [!]  Plain text only — HTML email is not supported

   [!]  credentials.json and token.json contain sensitive OAuth data
        Both are listed in .gitignore — do NOT commit to a public repo

   [i]  Tokens auto-refresh on expiry and are written back to token.json
        No manual re-auth required after initial setup

 ┌──────────────────────────────────────────────────────────────────────────┐
 │  :: FILE STRUCTURE                                                       │
 └──────────────────────────────────────────────────────────────────────────┘

   ShampMail/
   ├── server.js          - MCP server entry point
   ├── auth.js            - One-time OAuth2 authentication flow
   ├── package.json       - Dependencies and scripts
   ├── .gitignore         - Excludes credentials and token files
   ├── credentials.json   - OAuth2 client credentials   [DO NOT COMMIT]
   └── token.json         - OAuth2 access/refresh tokens  [DO NOT COMMIT]

////////////////////////////////////////////////////////////////////////////////
//  Provided as-is for personal use. Use responsibly.                        //
////////////////////////////////////////////////////////////////////////////////