Merge pull request #473 from ElcanoTek/feature/ses-s3-email-mcp

Add SES S3 Email MCP server for inbox polling

Author: bradflaugher

configs/crush/crush.template.json

@@ -124,6 +124,22 @@
         "SNOWFLAKE_USER": "${SNOWFLAKE_USER}",
         "SNOWFLAKE_PASSWORD": "${SNOWFLAKE_PASSWORD}"
       }
+    },
+    "email": {
+      "type": "stdio",
+      "command": "python3",
+      "args": ["${EMAIL_MCP_SCRIPT}"],
+      "cwd": "${EMAIL_MCP_DIR}",
+      "env": {
+        "AWS_ACCESS_KEY_ID": "${AWS_ACCESS_KEY_ID}",
+        "AWS_SECRET_ACCESS_KEY": "${AWS_SECRET_ACCESS_KEY}",
+        "AWS_REGION": "${AWS_REGION}",
+        "EMAIL_S3_BUCKET": "${EMAIL_S3_BUCKET}",
+        "EMAIL_S3_PREFIX": "${EMAIL_S3_PREFIX}",
+        "EMAIL_ATTACHMENT_DIR": "${EMAIL_ATTACHMENT_DIR}",
+        "EMAIL_LAST_CHECK_FILE": "${EMAIL_LAST_CHECK_FILE}",
+        "PYTHONPATH": "${EMAIL_MCP_DIR}"
+      }
     }
   }
 }

example.env

@@ -38,4 +38,26 @@ SMITHERY_BROWSERBASE_URL="https://server.smithery.ai/@browserbasehq/mcp-browserb
 # -------------------------------
 SNOWFLAKE_ACCOUNT="your-snowflake-account-here"       # e.g. xy12345.us-east-1
 SNOWFLAKE_USER="your-snowflake-username-here"         # e.g. ELYSE
-SNOWFLAKE_PASSWORD="your-pat-token-here"              # paste your PAT (API key) here
+SNOWFLAKE_PASSWORD="your-pat-token-here"              # paste your PAT (API key) here
+
+# -------------------------------
+# AWS SES + S3 Email Inbox Configuration
+# For receiving emails via AWS SES and storing in S3
+# -------------------------------
+
+# AWS Credentials (create an IAM user with S3 read access)
+AWS_ACCESS_KEY_ID="your-aws-access-key-id-here"
+AWS_SECRET_ACCESS_KEY="your-aws-secret-access-key-here"
+AWS_REGION="us-east-2"
+
+# S3 bucket where SES deposits emails
+EMAIL_S3_BUCKET="victoria-email-inbox"
+
+# Prefix (folder) within the bucket where emails are stored
+EMAIL_S3_PREFIX="emails/"
+
+# Local directory to save downloaded attachments
+EMAIL_ATTACHMENT_DIR="${HOME}/Victoria/email_attachments"
+
+# File to track when inbox was last checked
+EMAIL_LAST_CHECK_FILE="${HOME}/Victoria/email_last_checked.txt"

requirements.txt

@@ -1,5 +1,6 @@
 altair
 black
+boto3
 duckdb
 email-validator
 flake8