Source: https://cli.nylas.com/docs/commands/email-mark-starred

# nylas email mark starred

Star or flag an email.

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## 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

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

## Flags

| 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

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

### Star a specific email

```bash
nylas email mark starred msg_abc123
```

### Star all emails from a VIP sender

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

## Example output

```text
✓ 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.

## Related commands

[nylas email ai analyzeAnalyze recent emails with AI for a summary, categorization, and action items.](https://cli.nylas.com/docs/commands/email-ai-analyze)

[nylas email attachments downloadDownload an attachment](https://cli.nylas.com/docs/commands/email-attachments-download)

[nylas email attachments listList all attachments on a specific email.](https://cli.nylas.com/docs/commands/email-attachments-list)

[nylas email deleteDelete an email by message ID.](https://cli.nylas.com/docs/commands/email-delete)

[nylas email drafts createCreate a new draft email with optional attachments.](https://cli.nylas.com/docs/commands/email-drafts-create)

[nylas email drafts listList email drafts in your mailbox.](https://cli.nylas.com/docs/commands/email-drafts-list)

## Recommended guides

[List Fastmail emails from the CLIList Fastmail emails from the CLI through Nylas IMAP access, using app passwords, inbox filters, JSON output, and Fastmail-specific auth troubleshooting.](https://cli.nylas.com/guides/list-fastmail-emails)

[Why Cloud Servers Block SMTP PortsAWS, 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.](https://cli.nylas.com/guides/smtp-ports-blocked-on-cloud-servers)

[Send Email From a Docker ContainerCloud 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.](https://cli.nylas.com/guides/send-email-from-docker-container)

[MailerSend vs Nylas: Email ComparedMailerSend sends transactional email from verified domains. Nylas reads and syncs user inboxes across 6 providers. Compare features, pricing, and use cases.](https://cli.nylas.com/guides/mailersend-vs-nylas)

[Customer.io vs Nylas: Email ComparedCustomer.io sends lifecycle emails to your user base. Nylas reads and sends from real user inboxes via OAuth. Compare use cases, data access, and AI agents.](https://cli.nylas.com/guides/customerio-vs-nylas)

[Knock vs Nylas: Notifications vs Email APIKnock delivers multi-channel product notifications via workflows; Nylas provides two-way email and calendar sync. Compare scope, use cases, and agent support.](https://cli.nylas.com/guides/knock-vs-nylas)

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