Build / Gemini CLI + AgenticEmail
Give Gemini CLI its own inbox
Register AgenticEmail's MCP server in the Gemini CLI and your agent can run full email threads on its own, from an address it controls.
Install
Connect the inbox
The Gemini CLI loads MCP servers from settings.json and speaks streamable HTTP natively - point it at AgenticEmail with your key.
{
"mcpServers": {
"agenticemail": {
"httpUrl": "https://api.agenticemail.dev/mcp",
"headers": {
"Authorization": "Bearer ${AGENTICEMAIL_API_KEY}"
}
}
}
}export AGENTICEMAIL_API_KEY="am_your_unscoped_key"The MCP server works with any MCP client and needs an unscoped API key. See the MCP docs for the exact config path for your setup.
Why email
Why Gemini CLI needs its own inbox
Acts without you in the loop
Your agent can start outreach, reply to incoming mail, and run threads to completion on its own. You review the result, not every keystroke.
A dedicated agent identity
The agent gets its own inbox and address. No shared credentials, no routing through your personal account, no scope creep into your real mail.
A full audit trail
Every message it sends or receives is stored with its thread. Scoped API keys mean you can revoke one agent without touching the others.
Code
Working code
Prefer to script it directly? The same inbox is one SDK or CLI call away.
from agenticemail import AgenticEmail
client = AgenticEmail(api_key="am_your_key")
inbox = client.inboxes.create(username="support-agent")
print(inbox["id"])
client.messages.send(
inbox["id"],
to=["customer@example.com"],
subject="Hello from your agent",
text="Sent by an AI agent via AgenticEmail.",
)
replies = client.messages.list(inbox["id"])
for msg in replies["data"]:
print(msg["from"], msg["subject"])Prompt it directly
- "Create an inbox called support-agent and email the customer their ticket number."
- "Summarise the unread threads in the recruiting inbox and draft replies."
- "Follow up with anyone in the outreach thread who has not replied in three days."
FAQ
Common questions
- How does Gemini CLI connect to AgenticEmail?
- Through AgenticEmail's hosted MCP server at https://api.agenticemail.dev/mcp. You register it once with your API key, and Gemini CLI can call every inbox and message operation as native tools - no SMTP, no email provider, no glue code.
- Do I need to configure SMTP or an email provider?
- No. AgenticEmail is the provider. Inboxes are real addresses that send and receive; MCP exposes create_inbox, send_message, list_messages, reply_to_message and more directly to the agent.
- Can Gemini CLI receive email, not just send it?
- Yes. The agent can list threads and messages, read full history, and reply in the same thread. Inbound mail arrives parsed and is available through the same tools.
- Why does the MCP server need an unscoped key?
- The MCP server exposes inbox creation and cross-inbox operations, so it requires a key that is not locked to a single inbox. Create one at app.agenticemail.dev/keys.
- Is there a free tier?
- Yes. You can create inboxes and start sending on the free tier with no credit card. See the pricing page for limits.
