gmail-app-password-mcp 1.0.0

package/README.md

@@ -0,0 +1,129 @@
+# 📧 Gmail MCP Server
+
+Connect Claude directly to your Gmail — send emails, list messages, and read emails!
+
+---
+
+## 🚀 Quick Setup (5 Steps)
+
+### Step 1 — Get Google OAuth Credentials
+
+1. Go to [Google Cloud Console](https://console.cloud.google.com/)
+2. Create a **new project** (or select an existing one)
+3. Go to **APIs & Services → Library** → Search **"Gmail API"** → Click **Enable**
+4. Go to **APIs & Services → Credentials**
+5. Click **Create Credentials → OAuth 2.0 Client IDs**
+6. Choose **Desktop app** → Give it a name → Click **Create**
+7. Click **Download JSON** and save it as **`credentials.json`** in this folder
+
+---
+
+### Step 2 — Install Dependencies
+
+```bash
+cd gmail-mcp
+npm install
+```
+
+---
+
+### Step 3 — Authorize the App (one-time only)
+
+```bash
+node auth.js
+```
+
+- It will print a Google URL — open it in your browser
+- Sign in with your Gmail account
+- Copy the authorization code shown
+- Paste it back in the terminal
+- A `token.json` file will be saved — **keep this secret!**
+
+---
+
+### Step 4 — Add to Claude Desktop
+
+Open your Claude Desktop config file:
+
+| OS      | Path                                                        |
+|---------|-------------------------------------------------------------|
+| macOS   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json`              |
+| Linux   | `~/.config/Claude/claude_desktop_config.json`              |
+
+Add this to the `mcpServers` section:
+
+```json
+{
+  "mcpServers": {
+    "gmail": {
+      "command": "node",
+      "args": ["/ABSOLUTE/PATH/TO/gmail-mcp/index.js"]
+    }
+  }
+}
+```
+
+> ⚠️ Replace `/ABSOLUTE/PATH/TO/gmail-mcp/` with the actual full path to this folder.
+
+---
+
+### Step 5 — Restart Claude Desktop
+
+Quit and reopen Claude Desktop. You should see Gmail tools available! 🎉
+
+---
+
+## 🛠️ Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `send_email` | Send an email to anyone |
+| `list_messages` | List recent emails (with optional search) |
+| `read_email` | Read the full content of an email |
+
+---
+
+## 💬 Example Prompts
+
+```
+Send an email to friend@gmail.com saying happy birthday!
+
+List my last 5 emails from boss@company.com
+
+Read the email with ID 18f2a3b4c5d6e7f8
+```
+
+---
+
+## 🔒 Security Notes
+
+- `credentials.json` and `token.json` give access to your Gmail — **never share them**
+- Add both files to `.gitignore` if using Git
+- The token auto-refreshes, so you only need to run `auth.js` once
+
+---
+
+## 🐛 Troubleshooting
+
+**"credentials.json not found"** → Make sure you downloaded and placed the file correctly (Step 1)
+
+**"No token found"** → Run `node auth.js` again (Step 3)
+
+**"Access blocked"** → In Google Cloud Console, go to OAuth consent screen → Add your Gmail as a test user
+
+---
+
+## 📁 File Structure
+
+```
+gmail-mcp/
+├── index.js          ← MCP server (main file)
+├── auth.js           ← One-time authorization script
+├── package.json      ← Dependencies
+├── credentials.json  ← Your Google OAuth credentials (you add this)
+├── token.json        ← Auto-generated after running auth.js
+└── README.md         ← This file
+```
+
+

package/index.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+/**
+ * Gmail MCP Server (App Password version - no OAuth needed!)
+ */
+
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} = require("@modelcontextprotocol/sdk/types.js");
+const nodemailer = require("nodemailer");
+
+// ── Your Gmail credentials (edit these two lines!) ──────────────────────────
+const GMAIL_USER = "paraschauhan05112001@gmail.com";  // your Gmail
+const GMAIL_APP_PASSWORD = "zfuy wpew zrde nmij"; // paste app password here (no spaces)
+// ─────────────────────────────────────────────────────────────────────────────
+
+const transporter = nodemailer.createTransport({
+  service: "gmail",
+  auth: {
+    user: GMAIL_USER,
+    pass: GMAIL_APP_PASSWORD,
+  },
+});
+
+const server = new Server(
+  { name: "gmail-mcp", version: "2.0.0" },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "send_email",
+      description: "Send an email via Gmail to anyone",
+      inputSchema: {
+        type: "object",
+        properties: {
+          to: {
+            type: "string",
+            description: "Recipient email address",
+          },
+          subject: {
+            type: "string",
+            description: "Subject of the email",
+          },
+          body: {
+            type: "string",
+            description: "Body of the email",
+          },
+        },
+        required: ["to", "subject", "body"],
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  if (name === "send_email") {
+    const { to, subject, body } = args;
+
+    try {
+      const info = await transporter.sendMail({
+        from: `"Gmail MCP" <${GMAIL_USER}>`,
+        to,
+        subject,
+        text: body,
+      });
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: `✅ Email sent successfully!\nTo: ${to}\nSubject: ${subject}\nMessage ID: ${info.messageId}`,
+          },
+        ],
+      };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: `❌ Failed to send email: ${err.message}` }],
+        isError: true,
+      };
+    }
+  }
+
+  throw new Error(`Unknown tool: ${name}`);
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Gmail MCP server running (App Password mode)...");
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "gmail-app-password-mcp",
+  "version": "1.0.0",
+  "description": "Gmail MCP server using App Password - easiest Gmail setup for Claude",
+  "main": "index.js",
+  "bin": {
+    "gmail-app-password-mcp": "./index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "nodemailer": "^6.9.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}