Reference data

The facts on this page are the ones the server itself serves to the assistant with get_reference (one topic, or all) and as MCP resources maylee://reference/<topic>. They are generated from the same data, so they always match what the tools accept.

Label colorsCopy Anchor Link

Labels and AI labels use one of seven color names, case-sensitive. The MCP server refuses hex values and other names: the app would show them without color.

A new manual label gets Pink in the app, and new AI labels rotate through the list in this order.

View iconsCopy Anchor Link

A view icon is exactly one emoji, not an icon name or text. These are the 48 emojis of the app picker. Most other single emojis are accepted too, but long combined emojis (several emojis joined, such as ❤️‍🔥 or 👩🏽‍💻) cannot be stored and are refused.

A new view gets 😎 in the app.

Filter grammarCopy Anchor Link

The grammar of view filters (create_view, update_view) and of the filters parameter of list_emails. It differs from the REST filter tree: conditions use field, operator and value, and groups add one level of nesting. Unlike the REST API, invalid dates are rejected, never ignored.

FilterSpec = {
  match: 'all' | 'any'
  conditions: Condition[]
  groups?: { match: 'all' | 'any'; conditions: Condition[] }[]
}
Condition = { field, operator, value? }

• match all = every condition and group must hold; match any = at least one.
• groups add one level of nesting: each group has its own match and conditions.
• There is no folder field: choose the folder with list_emails folder (views show INBOX by default).
• Only label, ai_label and keyword_subject have a negative operator (not_contains); a sender cannot be excluded with this grammar.
• Label conditions take label ids, never names.
• At most 50 conditions in total, 500 characters per value.
• Queries are stopped after 10 seconds (QUERY_TIMEOUT).

{
  "match": "any",
  "conditions": [
    {
      "field": "sender_domain",
      "operator": "equals",
      "value": "substack.com"
    },
    {
      "field": "sender_domain",
      "operator": "equals",
      "value": "mailchimp.com"
    }
  ]
}

{
  "match": "all",
  "conditions": [
    {
      "field": "ai_label",
      "operator": "contains",
      "value": "<id of the Invoices AI label>"
    },
    {
      "field": "read_status",
      "operator": "is_false"
    },
    {
      "field": "date",
      "operator": "between",
      "value": "2026-09-01T00:00:00.000Z|2026-09-30T23:59:59.999Z"
    }
  ]
}

{
  "match": "all",
  "conditions": [
    {
      "field": "has_attachment",
      "operator": "is_true"
    },
    {
      "field": "keyword_subject",
      "operator": "not_contains",
      "value": "newsletter"
    }
  ],
  "groups": [
    {
      "match": "any",
      "conditions": [
        {
          "field": "sender_domain",
          "operator": "equals",
          "value": "client-a.com"
        },
        {
          "field": "sender_domain",
          "operator": "equals",
          "value": "client-b.com"
        }
      ]
    }
  ]
}

AI label rulesCopy Anchor Link

An AI label rule is an AI label plus a plain-language condition. Maylee reads each new incoming email and applies the label when the condition matches. A rule can also prepare a reply draft (Auto-Draft), send it automatically (Auto-Reply) and hide matching emails from the main inbox.

• Classification is available on every plan and applies to INBOX emails synced after the rule exists. Each classified email uses the workspace monthly AI allowance, shared with Magic Reply and Auto-Draft; when it runs out, AI features pause until the 1st of the month.
• Maylee has no notification that fires when a label is applied. The labels entries of update_notification_settings only mute or allow notifications about emails that carry an AI label.
• classify_existing_emails applies the rules to emails already in the inbox (labels only: it never drafts, replies or forwards).
• Deleting a rule deletes its AI label, which is removed from every email (emails are not deleted).
• AI labels cannot be renamed or recolored with the label tools: use update_ai_label_rule.

Auto-forward rulesCopy Anchor Link

A rule forwards every new matching inbox email to another address, automatically.

• Rules run on new INBOX emails received less than 24 hours ago, from the moment the rule exists.
• Forwarding to one of the workspace's own mailboxes or back to the original sender is ignored.
• When several rules target the same destination, the first matching rule wins.
• Failed forwards are not retried. get_auto_forward_logs shows the last 50 attempts of a rule.
• Creating or changing a rule needs the Send permission and confirm true: it sends the user's email to a third party automatically and continuously.

Inbox filtersCopy Anchor Link

• Inbox filters hide matching emails from the main inbox only; they are not moved or deleted.
• Filters are evaluated when the inbox is displayed, so they apply to past emails too and deleting a filter brings the emails back.
• Custom views and other folders are never reduced by inbox filters.
• Hidden emails are listed with list_emails systemView hidden_by_filters.

Snippet iconsCopy Anchor Link

Snippets (called smart links in the app) use one of these icon names, exactly as written:

CalendarPhoneAt SignLinkFileMessageBookmarkHashClockLocationStarHeartBriefcaseUsersShieldIdeaSendZapSparklesPen

Signature iconsCopy Anchor Link

PencilSignatureUsersShieldIdeaSendZapSparklesPen

Folders and system viewsCopy Anchor Link

• There is no Archive in Maylee. Provider folders such as Archive or custom Gmail labels are reported as folder OTHER.
• Emails can be moved to INBOX or SPAM, and sent to TRASH with trash_emails. Drafts cannot be moved.
• list_emails folder ALL covers every folder including spam and trash.

SchedulingCopy Anchor Link

sendAt is YYYY-MM-DDTHH:mm, local wall-clock time in the workspace timezone, without offset, for example 2026-10-01T09:30. Allowed from 60 seconds to 365 days ahead.

• The workspace timezone must be set once before scheduling (set_workspace_timezone). get_workspace tells whether it is set.
• Once sent, a scheduled draft leaves Drafts and appears in Sent.
• Daylight saving time: an ambiguous local time uses its first occurrence; a local time that does not exist is moved forward.
• cancel_scheduled_send turns it back into an ordinary draft.

ResourcesCopy Anchor Link

The same reference, one Markdown resource per topic, for clients that read MCP resources: