Command
nylas agent account list
The nylas agent account list command displays every managed agent email identity (provider=nylas) provisioned on the active application. Each entry shows the email address, account ID, and status. Agent accounts replace the deprecated nylas inbound surface and are used for E2E testing, transactional receive, and giving an AI agent its own inbox without OAuth.
Written by Qasim Muhammad Staff SRE
What does nylas agent account list do?
The nylas agent account list command displays every managed agent email identity (provider=nylas) provisioned on the active application. Each entry shows the email address, account ID, and status. Agent accounts replace the deprecated nylas inbound surface and are used for E2E testing, transactional receive, and giving an AI agent its own inbox without OAuth.
Usage
nylas agent account listFlags
| Flag | Description |
|---|---|
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |
Examples
List agent accounts
nylas agent account listJSON output
nylas agent account list --jsonTroubleshooting
No agent accounts shown
Create one with nylas agent account create <email>. Run nylas agent status to confirm the nylas connector is available on this application.
Migrating from nylas inbound
nylas inbound is deprecated. nylas agent account list is the direct replacement; existing inbound inboxes appear as agent accounts.
Recommended guides
Build a Transactional Email Agent
Send receipts, confirmations, and alerts from a dedicated agent account — DKIM-signed, idempotent, and rate-capped by a workspace policy, no SMTP relay.
Trigger Agents on Inbound Email with Webhooks
Replace cron polling with webhooks: register a message.created hook so your agent account wakes the agent the instant mail arrives, signature-verified.
Build an Email Digest Agent
Send an opt-in digest to a subscriber group from an agent account — resolve the recipient list from contacts, honor unsubscribes, and send on a schedule.
Migrate from SMTP to Agent Accounts
Move an agent's email off a self-hosted SMTP server: map sends to one CLI command, replace your MX with managed inbound, and cut over with a safety net.
Deploy Agent Accounts in Docker & CI
Run an agent-account agent in a container or CI pipeline: install the CLI, authenticate headlessly with an API key, and keep the key out of image layers.
Build a Recruiting Interview Coordinator
An AI agent schedules interviews across a candidate and an interview panel: it finds slots that fit every panelist, emails the options, and books the panel.
Use Agent Accounts with LangChain
Give a LangChain or LangGraph agent email and calendar by wrapping the Nylas CLI as tools — one subprocess call per action, JSON in and out, no provider SDK.
Build a Signup & Verification Bot
An AI agent signs up for services and reads its own verification codes. Give the bot a real inbox on an agent account and pull the OTP with one CLI command.
Build a Personal Assistant Inbox Agent
Delegate an overflow inbox to an AI assistant on an agent account. It triages forwarded mail, drafts replies into a review queue, and sends a daily brief.
Build an Order-Status Reply Agent
An AI agent answers where-is-my-order emails: it reads the request, extracts the order ID, looks it up in your system, and replies only to the verified owner.
Build an AutoGen Email Agent
Give an AutoGen agent email by registering the Nylas CLI as a function tool — one subprocess per action, JSON in and out, across 6 providers with no SDK.
Email Tools for the Vercel AI SDK
Add email to a Vercel AI SDK agent with a tool() that shells out to the Nylas CLI. JSON output and read/send across 6 providers with no per-provider SDK.
Build a CrewAI Email Agent
Give a CrewAI agent email by wrapping the Nylas CLI as a tool — one subprocess call per action, JSON in and out, across 6 providers, with no per-provider SDK.
Mailgun vs Nylas: When to Use Each
Mailgun sends and routes email from your domain. Nylas reads and sends from a user's inbox across 6 providers. Pricing, inbound routing, and a decision guide.
How to Evaluate an Email AI Agent
Evaluate an email agent with a labeled test set, classification and action-accuracy metrics, and prompt-injection guardrail tests you run on every change.
Give Your AI Agent a Managed Calendar
An agent account includes calendar access on the same grant as email. Check availability, find meeting times across timezones, and book events from the CLI.
Build a Meeting-Booking Assistant Agent
Build an AI scheduling agent on a Nylas agent account. It reads a request email, finds a time across timezones, books the event, and emails a confirmation.
Give Your AI Agent a Contacts Directory
An agent account carries contacts on the same grant as email and calendar. Add contacts, resolve names to addresses, group recipients, and dedupe from the CLI.
Build an AI Customer-Support Inbox
Run an AI support agent on a dedicated agent account: read tickets, triage by sender and content, reply in-thread, escalate hard cases, and stay contained.
Manage the Agent Account Lifecycle
Create, inspect, rotate credentials, pause, and delete agent accounts from the CLI — the full lifecycle of a managed agent email identity, step by step.
Provision Agent Accounts at Scale
Bulk-create agent accounts from a tenant list, make provisioning idempotent, apply shared guardrails, inventory the fleet, and tear down — all from the CLI.
Build a Lead-Capture & Qualification Agent
An AI agent reads inbound leads, qualifies each one, saves the good ones to a contacts directory, and notifies sales — fast enough to beat lead decay.
Monitor Agent Account Health
Probe agent account and connector health from the CLI, flag any account that isn't valid across the fleet, and send an alert before an agent fails a task.
Build an Invoice-Intake Agent
An AI agent reads inbound invoices, downloads the PDF attachment, extracts vendor, amount, and due date, and routes a summary to accounting — hands-free.
Outlook OAuth for AI Agents: Graph Setup
Set up OAuth for AI agents that automate Outlook email: Graph app registration, delegated vs application Mail.Send, token lifetimes, and a faster CLI path.
Gmail API Sandbox: Test Email Integrations
Gmail has no API sandbox. Compare the real options: a dedicated test account, the Amazon SES sandbox, fake SMTP inboxes, and nylas demo with sample data.
Password Reset Emails: Choosing an API
Password reset emails are latency-critical transactional sends. Compare SES, Postmark, SendGrid, and Nylas, meet Gmail's sender rules, and test the loop.
AI Agent Audit Dashboard from the CLI
Build an audit dashboard for AI agent activity: per-agent command counts, error rates, session replay, and cron snapshots from nylas audit logs and jq.
Calendar Invite Prompt Injection Defense
Calendar invites land in an AI agent's context without any click. Defend with organizer allowlists, metadata-first triage, human-run RSVPs, and audit logs.
Build an AI Email Auto-Responder
Build an AI auto-responder that reads incoming email, drafts context-aware replies with an LLM, and sends after human approval. Python and CLI pipeline.
Email Forwarding Rules: API Guide
Compare Gmail filter API, Microsoft Graph inbox rules, and CLI-based email rules for programmatic email routing. Create and manage rules across providers.
Build a Human-in-the-Loop Email Agent
Build an AI email agent with human approval gates. Classify messages, draft responses, queue for review, and send only after a human confirms each action.
AgentMail vs Nylas vs Cloudflare Email
Compare AgentMail, Cloudflare Email for Agents, and Nylas Agent Accounts. Feature matrix, pricing, MCP support, and a decision guide for AI agent email in 2026.
Email Prompt Injection Defense
Defend AI email agents against prompt injection attacks. Input separation, capability sandboxing, human-in-the-loop approvals, and audit logging patterns.
Mailtrap Alternative for Real Inbox Testing
Compare Mailtrap, Mailosaur, and Nylas Agent Accounts for testing transactional email flows with real inbox delivery.
Parse Inbound Email Webhooks
Register inbound email webhooks, verify signatures, and parse message.created payloads into JSON your app can process.
Cypress Email Testing
Test password resets, magic links, and OTP emails in Cypress with a real inbox, Nylas CLI JSON output, and isolated agent accounts.
Test Email Webhooks Locally
Test Nylas email webhooks locally with tunnel setup, signed payload checks, trigger discovery, and replayable fixtures before shipping handlers.
Agent-to-Agent Email Communication
Two AI agents, two managed inboxes, one protocol. Create agent accounts with Nylas CLI and exchange structured JSON messages — no shared database needed.
Stop Your AI Agent From Going Rogue
Terminate rogue AI agent sessions at the connector layer. Outbound blocks, auto-reply kill switches, and prompt-injection containment — all before SMTP.
Install Nylas Skills for AI Coding Agents
Install nylas-cli and nylas-api skills in Claude Code, Cursor, Codex CLI, Windsurf, and 30+ AI coding agents. One command adds email and calendar tools.
Create an AI Agent Email Identity
Set up a managed email identity for an AI agent. Create a dedicated inbox, send and receive in 2 minutes — no OAuth setup or third-party mailbox needed.
Build an AI Email Triage Agent
Build an AI agent that reads your inbox, classifies emails by urgency, drafts replies, and archives noise. Python + Nylas CLI + any LLM. Full code included.
Receive Email Without an SMTP Server
Create a managed agent email account and process incoming messages via webhooks — no Postfix, no MX records. Uses nylas agent create and monitor commands.
Extract OTP Codes from Email — Skip the Inbox
Pull 2FA verification codes from email without opening your inbox. The nylas otp get command copies the latest code to your clipboard across all providers.
Give Your AI Coding Agent an Email Address
Connect Claude Code, Cursor, OpenAI Codex CLI, Windsurf, and OpenClaw to a real email account via MCP. Step-by-step setup for each tool using Nylas CLI.
Send Email from Linux/Manus Sandbox Without SMTP
Send email from a Linux or Manus sandbox over HTTPS when SMTP ports 25, 465, and 587 are blocked. No Postfix or sendmail — Nylas CLI handles delivery.
Manus AI Email Research Agent
Use Manus AI to deep-search your inbox, summarize long email threads, extract decisions and action items, and compile research reports with Nylas CLI.
Build an Email Support Agent with Manus AI
Build a Manus AI support agent that polls a shared inbox, matches tickets to knowledge base articles, drafts context-aware replies, and escalates risk.
Reach Inbox Zero with Manus AI
Reach inbox zero with Manus AI and Nylas CLI. Triage unread messages by urgency, auto-categorize threads, draft replies, and bulk-archive noise in one go.
Mail Manus: Automate Email from CLI
Compare Mail Manus forwarding with direct inbox access. Learn when to add the Nylas CLI Skill for search, sending, follow-ups, and calendar workflows.
CI/CD Email Alerts with PowerShell
Send build failure alerts, deployment reports, and test results from GitHub Actions, Azure DevOps, and Jenkins pipelines using PowerShell and Nylas CLI.
Create a Manus Skill: Email & Calendar Workflow
Create a Manus Skill that installs Nylas CLI in the sandbox and teaches your agent email, calendar, and contact workflows via SKILL.md and setup scripts.
E2E Email Testing with Playwright
Test password reset, invitation, and verification emails end-to-end. Poll with Nylas CLI, verify content in Playwright, and click links. No Gmail config needed.
AI Agent CLI for Email and Calendar
Build an AI agent CLI for email and calendar with Nylas CLI subprocess commands, JSON output, and no provider-specific API clients.
Run nylas agent account list --help for full help output.