Add SES S3 Email MCP server for inbox polling #473
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This adds a new MCP server that allows Victoria to: - Poll an S3 bucket for emails deposited by AWS SES - Get email details (subject, from, to, attachments) - Download attachments (especially CSV files) for data analysis Files added/modified: - ses_s3_email_mcp.py: New MCP server with 5 tools - check_inbox: List new emails since last check - get_email: Get parsed email details - download_attachment: Download a specific attachment - download_all_csv_attachments: Batch download CSVs - get_inbox_stats: Get inbox statistics - example.env: Added AWS/S3 configuration variables - configs/crush/crush.template.json: Added email MCP config Setup requires: - AWS SES configured to receive emails for a domain - S3 bucket with SES receipt rule to store emails - IAM user with S3 read access
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
…nal.py - Added boto3 to requirements.txt - Added EMAIL_ENV_KEYS constant for required env vars - Added _is_email_enabled() function to check if email MCP should be enabled - Added email MCP configuration setup in write_crush_config() to set EMAIL_MCP_SCRIPT and EMAIL_MCP_DIR automatically (same pattern as SendGrid)
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds a new MCP server that gives Victoria the ability to check an email inbox. Emails are received by AWS SES and stored in an S3 bucket, which Victoria can poll on demand.
What's Included
New File:
ses_s3_email_mcp.pyA complete MCP server with 5 tools:
check_inboxget_emaildownload_attachmentdownload_all_csv_attachmentsget_inbox_statsUpdated Files
Prerequisites
The AWS infrastructure has already been set up:
victoria-email-inbox) createdvictoria.elcanotek.comEnvironment Variables Required
Testing
After merging, test by:
[email protected]