Command

nylas email mark starred

Star or flag an email.

Written by Qasim Muhammad Staff SRE

What does nylas email mark starred do?

The nylas email mark starred command adds a star (Gmail) or flag (Outlook, Exchange) to a message by its ID. Use it to highlight important emails from scripts or AI agents across Gmail, Outlook, Exchange, and IMAP mailboxes connected to the CLI.

Usage

nylas email mark starred <message-id> [grant-id]

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
--limitLimit results (most list commands)
--yes(-y)Skip confirmations

Examples

The nylas email mark starred command adds a star (Gmail) or flag (Outlook, Exchange) to a message by its ID.

Star a specific email

nylas email mark starred msg_abc123

Star all emails from a VIP sender

nylas email list --from ceo@company.com --json | jq -r '.[].id' | xargs -I{} nylas email mark starred {}

Example output

✓ Message starred
  Message ID: msg_abc123

Troubleshooting

Star not visible in webmail

Outlook uses flags instead of stars. The flag should appear in your Outlook flagged view, not the starred folder.

Cannot star emails on IMAP

Verify your IMAP server supports the \Flagged keyword. Some minimal IMAP servers don't support flags.

Recommended guides

Run nylas email mark starred --help for full help output.