Email for CrewAI Agents: Give a Crew a Real Mailbox

# Keys are issued from the dashboard, not over REST - the issuance surface is
# deliberately not agent-callable, so a leaked key can never mint or revoke
# another. To get one: Dashboard → API keys → pick the mailbox + a role
# (read / read_write / management) + an optional expiry → copy the sm_live_…
# secret (it is shown ONCE). Then set it for your agent and pass it as the
# Bearer token on every REST + MCP call:
export SAIRAPH_MAIL_KEY="sm_live_…"

import os

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter

server_params = {
    "url": "https://mail.sairaph.com/mcp/v1/mcp",
    "transport": "streamable-http",
    "headers": {
        "Authorization": f"Bearer {os.environ['SAIRAPH_MAIL_KEY']}",
    },
}

with MCPServerAdapter(server_params) as mailbox_tools:
    mailbox_agent = Agent(
        role="Mailbox operator",
        goal="Send outreach and read back the replies for the crew.",
        backstory="Owns the crew's email address and handles all inbound and outbound.",
        tools=mailbox_tools,
        verbose=True,
    )

send_task = Task(
        description="Email agent@acme.dev a verification code and confirm it was queued.",
        expected_output="The message id and queued status.",
        agent=mailbox_agent,
    )

crew = Crew(agents=[mailbox_agent], tasks=[send_task])
    print(crew.kickoff())

curl https://mail.sairaph.com/api/v1/mailboxes/$MAILBOX_ID/outbound \
  -H "Authorization: Bearer $SAIRAPH_MAIL_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["agent@acme.dev"],
    "subject": "Your verification code",
    "body_text": "Reply with APPROVE to continue."
  }'

# Read inbound from cache, or live=true for an on-demand fetch.
curl "https://mail.sairaph.com/api/v1/mailboxes/$MAILBOX_ID/messages?direction=inbound&live=true" \
  -H "Authorization: Bearer $SAIRAPH_MAIL_KEY"