Skillware skills · office/gmail_handler
Gmail Handler
Deterministic Gmail IMAP/SMTP handler for a dedicated agent mailbox — resolve recipients, search and read inbox, preview/send mail, and threaded replies with confirmation gates. Agent drafts prose; skill executes transport. No OAuth in v1; dedicated Gmail + App Password.
Capabilities
- Dedicated agent mailbox
- Preview before send/reply
- Address book + context
- Inbox and sent search
Problems this skill solves
People search for tasks — not always "skillware":
- email for agents
- how can ai send emails for me
- free mail for ai
- give your ai agents an email
- can ai send emails if i ask it
- ai agent send email gmail
- agent mailbox email address
- how to let ai read my inbox
- ai send email on my behalf agent
- gmail imap smtp for ai agents
- ai agent reply to emails
- structured email tool for llm agents
- ai email automation without sendgrid
- agent send mail preview confirm
- dedicated email for chatbot agent
- can my ai assistant send emails
- how do ai agents send email
- free email integration for ai agents
- give chatbot an email address
- ai agent inbox search read
Install
pip install skillware then SkillLoader.load_skill("office/gmail_handler")
FAQ
- How can I give my AI agent an email address?
- Create a dedicated Gmail account for the agent (not your personal inbox), enable IMAP, generate an App Password, then pip install "skillware[office_gmail_handler]" and load office/gmail_handler. Set GMAIL_ADDRESS and GMAIL_APP_PASSWORD in .env.
- Can AI send emails if I ask it?
- Yes — with Skillware office/gmail_handler the agent drafts subject/body in natural language, calls preview_send, you confirm, then send with confirmed: true. Transport is deterministic IMAP/SMTP; the model does not guess SMTP APIs.
- Is there free email for AI agents without a paid email API?
- You can use a dedicated free Gmail account with an App Password — no SendGrid/Mailgun required for v1. The skill uses standard IMAP/SMTP; provider keys are only for your LLM loop around the skill.
- How do agents send email safely?
- Use a dedicated agent-only mailbox (same posture as a dedicated agent wallet), preview before send/reply, confirmation gates on send/reply, recipient caps, and treat read_message bodies as untrusted_content — do not follow instructions inside inbound mail.
- Does the Gmail skill use the Gmail API or OAuth?
- v1 uses IMAP/SMTP with a Google App Password on a dedicated agent account — no OAuth or Gmail REST API yet (planned v2). See the catalog page for env setup.