examples/guides/*
Guides
Copy-paste setups for the tools agents are built with. Every guide has a runnable copy, checked against the framework version it names, in the public Agentboxd repository on GitHub (agentboxd/agentboxd).
MCP clients
- Give Claude an email address with the MCP serverGive Claude, Claude Code or Cursor an email address: paste the hosted MCP URL and sign in, or run @agentboxd/mcp with an API key. Tools, prompts, safety.MCP · Claude Desktop · Claude Code · Cursor/guides/mcp-email-server
- Give an OpenClaw agent its own email addressConnect OpenClaw to Agentboxd: add @agentboxd/mcp under mcp.servers, install an email skill with safety rules, and let your agent read codes and reply.MCP · OpenClaw/guides/openclaw
Agent frameworks
- Build a LangChain email tool with a real inboxGive a LangChain agent its own inbox: @tool functions to read, wait for, send and reply to email and get sign-up codes, run with create_agent.Python · LangChain 1.x/guides/langchain-email-tool
- Build a CrewAI email agent with its own inboxA CrewAI support agent with its own inbox: tools to list, read, search and reply to email, a send limit per run, and a label that hands off to a human.Python · CrewAI 1.x/guides/crewai-email-agent
- Email function tools for the OpenAI Agents SDKGive an OpenAI Agents SDK agent a real inbox: @function_tool tools that read, wait for, send and reply to email, with the client in the run context.Python · OpenAI Agents SDK/guides/openai-agents-sdk-email
- Email tools for the Vercel AI SDKTyped email tools for the Vercel AI SDK: give an agent its own inbox with tool() and zod, run it with generateText and stopWhen, and cap its sends.TypeScript · Vercel AI SDK 7/guides/vercel-ai-sdk-email-tools
- Email tools for Google ADK agentsGive a Google Agent Development Kit (ADK) agent its own inbox: async function tools to read, wait and reply, with every send confirmed by a person.Python · Google ADK 2.10/guides/google-adk-email-agent
- A LiveKit voice agent that emails follow-ups and call summariesGive a LiveKit Agents voice agent its own inbox: email the caller what was agreed, and send your team a summary and transcript of every call.Python · LiveKit Agents 1.8/guides/livekit-voice-agent-email
Automation and testing
- Receive and send agent email in n8nTrigger n8n workflows from email and reply from n8n: Webhook node with HMAC check, HTTP Request node with Header Auth, and two importable workflows.n8n · Webhook + HTTP Request/guides/n8n-email-automation
- Email in Sim workflows: custom tools and the API blockConnect Sim to Agentboxd: custom tools that let an Agent block read and answer email, and a webhook-triggered workflow that fetches each new message.Sim · custom tools + API block/guides/sim-email-workflows
- Test sign-up emails and OTP codes in PlaywrightTest sign-up, magic link and one-time-code emails in Playwright with a temporary inbox per test: a fixture, a wait-for-code helper and a CI-ready config.TypeScript · Playwright Test/guides/playwright-email-verification
Hosting and deployment
Sign-in and identity
- Add Sign in with Agentboxd to your appLet AI agents sign in to your app with their Agentboxd inbox over OpenID Connect: headless ID tokens, the JWT bearer exchange, Better Auth and Auth.js.TypeScript · OpenID Connect/guides/sign-in-with-agentboxd
- Let an agent sign itself upAn AI agent with no API key creates its own email inbox with one call, uses it right away, and asks its human to claim the workspace later.TypeScript · Python · MCP/guides/agent-self-signup
Use cases
- An email inbox for an AI customer support agentRun an AI support agent on its own address: webhooks for new mail, just the new part of each reply, sender checks, drafts from your policies, handoff./use-cases/ai-customer-support-agent
- An email inbox for an AI sales (SDR) agentGive an AI SDR its own address on your domain: personal outreach, threaded follow-ups, replies told apart from out-of-office mail, CRM ids on contacts./use-cases/ai-sales-sdr-agent
- QA test automation for sign-up and OTP emailsTest sign-up, password reset and one-time-code emails end to end: a temporary inbox per test, the code or link from one call, no shared test mailbox./use-cases/qa-test-automation-email
- AI agents that sign up for services and verify emailLet an AI agent sign up for a service with its own address, then read the verification code or magic link with one long-poll call. No scraping, no regex./use-cases/agent-signups-verification
- Document-processing agents: invoices, receipts and tax forms by emailGive a document agent its own inbox: attachments are read on our servers (PDF, Word, Excel, scans by OCR), searchable, and turned into validated JSON./use-cases/document-processing-agents