AWS SES

AWSSESTool enables an Agent to send emails using Amazon Simple Email Service (SES).

Prerequisites

The following example requires the boto3 library and valid AWS credentials. You can install boto3 via pip:

uv pip install boto3

You must also configure your AWS credentials so that the SDK can authenticate to SES. The easiest way is via the AWS CLI:

aws configure
# OR set environment variables manually
export AWS_ACCESS_KEY_ID=****
export AWS_SECRET_ACCESS_KEY=****
export AWS_DEFAULT_REGION=us-east-1

Make sure to add the domain or email address you want to send FROM (and, if still in sandbox mode, the TO address) to the verified emails in the SES Console.

Example

The following agent researches the latest AI news and then emails a summary via AWS SES:

aws_ses_tools.py

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.aws_ses import AWSSESTool
from agno.tools.hackernews import HackerNewsTools

# Configure email settings
sender_email = "[e-mail]"  # Your verified SES email
sender_name = "Sender Name"
region_name = "us-east-1"

agent = Agent(
    name="Research Newsletter Agent",
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[
        AWSSESTool(
            sender_email=sender_email,
            sender_name=sender_name,
            region_name=region_name
        ),
        HackerNewsTools(),
    ],
    markdown=True,
        instructions=[
        "When given a prompt:",
        "1. Extract the recipient's complete email address (e.g. [e-mail])",
        "2. Research the latest AI developments using HackerNews",
        "3. Compose a concise, engaging email summarising 3 – 4 key developments",
        "4. Send the email using AWS SES via the send_email tool",
    ],
)

agent.print_response(
    "Research recent AI developments in healthcare and email the summary to [e-mail]"
)

Toolkit Params

Parameter	Type	Default	Description
sender_email	str	None	Verified SES sender address.
sender_name	str	None	Display name that appears to recipients.
region_name	str	"us-east-1"	AWS region where SES is provisioned.
enable_send_email	bool	True	Enable the send_email functionality.
all	bool	False	Enable all functionality.

Toolkit Functions

Function	Description
send_email	Send a plain-text email. Accepts the arguments: subject, body, receiver_email.

Developer Resources

• View Tools
• Amazon SES Documentation