Command

nylas contacts list

List all contacts from your address book.

Written by Qasim Muhammad Staff SRE

What does nylas contacts list do?

The nylas contacts list command displays contacts from your connected address book. Use --limit to control how many contacts are returned. Output includes name, email, phone, and company for each contact. Use --json for pipe-friendly output in scripts and automation. Works with Google Contacts, Outlook People, Exchange, Yahoo, iCloud, and IMAP providers.

Usage

nylas contacts list [--limit N] [--json]

Flags

FlagDescription
--jsonOutput as JSON
--no-colorDisable color output
--verbose(-v)Enable verbose output
--configCustom config file path
--help(-h)Show help for the command
--limitMaximum number of contacts to return
--yes(-y)Skip confirmations
--email(-e)Filter by email address
--idShow contact IDs
--source(-s)Filter by source (address_book, inbox, domain)

Examples

The nylas contacts list command displays contacts from your connected address book.

List first 20 contacts

nylas contacts list --limit 20

Export all contacts as JSON

nylas contacts list --json > contacts-backup.json

Count total contacts

nylas contacts list --json | jq length

Example output

NAME           EMAIL                 COMPANY
Alice Chen     alice@example.com     Acme Corp
Bob Smith      bob@example.com       Globex
Carol Diaz     carol@example.com     Initech

3 contacts

Troubleshooting

Only a subset of contacts returned

The default limit is 50. Use --limit 1000 or higher to fetch more. Some providers paginate results automatically.

Contacts from shared address books not showing

Shared/delegated address books require separate grant access. Only the primary address book for the authenticated account is listed by default.

Recommended guides

List Fastmail emails from the CLI

List Fastmail emails from the CLI through Nylas IMAP access, using app passwords, inbox filters, JSON output, and Fastmail-specific auth troubleshooting.

Manage contact groups from the CLI

Manage contact groups from the CLI: list, create, rename, and delete groups, then map Google groups and Microsoft contact folders with verified flags.

Why Cloud Servers Block SMTP Ports

AWS, GCP, and Azure block outbound SMTP port 25 while ports 587 and 465 stay open. Confirm the block and send email over an HTTPS API instead.

Send Email From a Docker Container

Cloud providers block SMTP port 25 from containers. Send email over an HTTPS API on port 443 with one command and no mail daemon at all.

MailerSend vs Nylas: Email Compared

MailerSend sends transactional email from verified domains. Nylas reads and syncs user inboxes across 6 providers. Compare features, pricing, and use cases.

Customer.io vs Nylas: Email Compared

Customer.io sends lifecycle emails to your user base. Nylas reads and sends from real user inboxes via OAuth. Compare use cases, pricing, and AI agent support.

Run nylas contacts list --help for full help output.