@agenticmail/mcp 0.3.0 → 0.5.0

package/README.md

@@ -2,7 +2,7 @@
 
 The MCP (Model Context Protocol) server for [AgenticMail](https://github.com/agenticmail/agenticmail) — gives any MCP-compatible AI client full email capabilities.
 
-When connected, your AI agent can send emails, check inboxes, reply to messages, manage contacts, schedule emails, assign tasks to other agents, and more — all through natural language. The server provides 54 tools that cover every email and agent management operation.
+When connected, your AI agent can send emails, check inboxes, reply to messages, manage contacts, schedule emails, assign tasks to other agents, and more — all through natural language. The server provides 62 tools that cover every email and agent management operation.
 
 ## Install
 
@@ -182,6 +182,19 @@ These tools require the master key:
 | `send_test_email` | Send a test email to verify gateway |
 | `purchase_domain` | Search for and purchase a domain |
 
+### SMS / Phone Number (8 tools)
+
+| Tool | Description |
+|------|-------------|
+| `sms_setup` | Configure Google Voice phone number for SMS access |
+| `sms_send` | Record and send SMS via Google Voice |
+| `sms_messages` | List inbound/outbound SMS messages |
+| `sms_check_code` | Extract verification/OTP codes from recent SMS |
+| `sms_read_voice` | Read SMS directly from Google Voice web (fastest method) |
+| `sms_record` | Record an SMS read from Google Voice web or any source |
+| `sms_parse_email` | Parse SMS from forwarded Google Voice email (fallback) |
+| `sms_config` | Get current SMS configuration |
+
 ---
 
 ## Outbound Security Scanning

package/dist/index.js

@@ -887,6 +887,93 @@ var toolDefinitions = [
       },
       required: ["action"]
     }
+  },
+  // --- SMS / Google Voice Tools ---
+  {
+    name: "sms_setup",
+    description: "Configure SMS/phone number access via Google Voice. The user must have a Google Voice account with SMS-to-email forwarding enabled. This gives the agent a phone number for receiving verification codes and sending texts.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        phoneNumber: { type: "string", description: "Google Voice phone number (e.g. +12125551234)" },
+        forwardingEmail: { type: "string", description: "Email address Google Voice forwards SMS to (defaults to agent email)" }
+      },
+      required: ["phoneNumber"]
+    }
+  },
+  {
+    name: "sms_send",
+    description: "Send an SMS text message via Google Voice. Records the message and provides instructions for sending via Google Voice web interface. The agent can automate the actual send using browser automation on voice.google.com.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        to: { type: "string", description: "Recipient phone number" },
+        body: { type: "string", description: "Text message body" }
+      },
+      required: ["to", "body"]
+    }
+  },
+  {
+    name: "sms_messages",
+    description: "List SMS messages (inbound and outbound). Use direction filter to see only received or sent messages.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        direction: { type: "string", enum: ["inbound", "outbound"], description: "Filter by direction" },
+        limit: { type: "number", description: "Max messages (default: 20)" },
+        offset: { type: "number", description: "Skip messages (default: 0)" }
+      }
+    }
+  },
+  {
+    name: "sms_check_code",
+    description: "Check for recent verification/OTP codes received via SMS. Scans inbound SMS for common code patterns (6-digit, 4-digit, alphanumeric). Use this after requesting a verification code during sign-up flows.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        minutes: { type: "number", description: "How many minutes back to check (default: 10)" }
+      }
+    }
+  },
+  {
+    name: "sms_parse_email",
+    description: "Parse an SMS from a forwarded Google Voice email. Use this when you receive an email from Google Voice containing an SMS. Extracts the sender number, message body, and any verification codes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        emailBody: { type: "string", description: "The email body text to parse" },
+        emailFrom: { type: "string", description: "The email sender address" }
+      },
+      required: ["emailBody"]
+    }
+  },
+  {
+    name: "sms_config",
+    description: "Get the current SMS/phone number configuration for this agent. Shows whether SMS is enabled, the phone number, and forwarding email.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "sms_read_voice",
+    description: "Get instructions and URL for reading SMS directly from Google Voice web (FASTEST method). Returns the voice.google.com URL and guidance for browser-based SMS reading. Primary method - much faster than email forwarding.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "sms_record",
+    description: "Record an SMS message read from Google Voice web or any other source. Saves to SMS database and extracts verification codes. Use after reading a message from voice.google.com.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        from: { type: "string", description: "Sender phone number" },
+        body: { type: "string", description: "SMS message text" }
+      },
+      required: ["from", "body"]
+    }
   }
 ];
 var MASTER_KEY_TOOLS = /* @__PURE__ */ new Set([
@@ -1983,6 +2070,69 @@ ${result.summary}`);
       }
       throw new Error("Invalid action. Use: list or get");
     }
+    // --- SMS / Google Voice Tools ---
+    case "sms_setup": {
+      const result = await apiRequest("POST", "/sms/setup", {
+        phoneNumber: args.phoneNumber,
+        forwardingEmail: args.forwardingEmail,
+        provider: "google_voice"
+      });
+      return JSON.stringify(result, null, 2);
+    }
+    case "sms_send": {
+      const result = await apiRequest("POST", "/sms/send", {
+        to: args.to,
+        body: args.body
+      });
+      return JSON.stringify(result, null, 2);
+    }
+    case "sms_messages": {
+      const query = new URLSearchParams();
+      if (args.direction) query.set("direction", String(args.direction));
+      if (args.limit) query.set("limit", String(args.limit));
+      if (args.offset) query.set("offset", String(args.offset));
+      const result = await apiRequest("GET", `/sms/messages?${query.toString()}`);
+      return JSON.stringify(result, null, 2);
+    }
+    case "sms_check_code": {
+      const query = args.minutes ? `?minutes=${args.minutes}` : "";
+      const result = await apiRequest("GET", `/sms/verification-code${query}`);
+      return JSON.stringify(result, null, 2);
+    }
+    case "sms_parse_email": {
+      const result = await apiRequest("POST", "/sms/parse-email", {
+        emailBody: args.emailBody,
+        emailFrom: args.emailFrom
+      });
+      return JSON.stringify(result, null, 2);
+    }
+    case "sms_config": {
+      const result = await apiRequest("GET", "/sms/config");
+      return JSON.stringify(result, null, 2);
+    }
+    case "sms_read_voice": {
+      const configResult = await apiRequest("GET", "/sms/config");
+      const phone = configResult?.sms?.phoneNumber || "unknown";
+      return JSON.stringify({
+        method: "google_voice_web",
+        phoneNumber: phone,
+        browserUrl: "https://voice.google.com/u/0/messages",
+        instructions: [
+          "Open the browser to: https://voice.google.com/u/0/messages",
+          "Take a screenshot to see the message list",
+          "Recent SMS messages appear in the sidebar with sender and preview",
+          "After reading, use sms_record to save the SMS to the database"
+        ],
+        tip: "This is much faster than email forwarding. Messages appear instantly."
+      }, null, 2);
+    }
+    case "sms_record": {
+      const result = await apiRequest("POST", "/sms/record", {
+        from: args.from,
+        body: args.body
+      });
+      return JSON.stringify(result, null, 2);
+    }
     default:
       throw new Error(`Unknown tool: ${name}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/mcp",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "MCP server for AgenticMail — use email from any MCP-compatible AI client",
   "type": "module",
   "main": "dist/index.js",
@@ -23,7 +23,7 @@
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",
     "dev": "tsx src/index.ts",
-    "test": "vitest run",
+    "test": "vitest run --passWithNoTests",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {