max-settings

View and update Max assistant preferences via the max settings CLI commands.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/api-evangelist/frontline --skill max-settings-api-evangelist
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: max-settings
Source: https://github.com/api-evangelist/frontline/tree/main/skills/vendor/max-settings
Command: npx skills add https://github.com/api-evangelist/frontline --skill max-settings-api-evangelist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing your Max assistant's behavior — timezone, personality, email drafting, follow-ups, and agent status — requires knowing which settings section holds each field and how partial updates merge. This Skill maps every preference to the correct max settings command so changes are made accurately without trial and error. ## Core Features & Use Cases - Five settings sections: scheduling (timezone, scheduling links), advanced (language, personality, global instructions), email (per-mailbox drafts, follow-ups, labels), overview (agent status), and knowledge-base toggle. - Safe update workflow: always get first, then update with a partial JSON object; updates merge except for the full-replacement schedulingLinks and email labels arrays. - Use Case: A user says "make my email drafts more formal and follow up after 3 days" — the Skill routes to max settings email get <id> to read the current shape, then updates draftInstructions and followUpAfter without touching the labels array. ## Quick Start Ask the assistant to change your Max timezone to America/Sao_Paulo using the max settings scheduling command.

Frequently Asked Questions about max-settings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I change my Max assistant timezone?▼

Run max settings scheduling update with a JSON object containing an IANA timezone id, for example {"timezone":"America/Sao_Paulo"}. Changing timezone also re-times all Max periodic tasks. The overview section shows timezone read-only; use scheduling to change it.

How do I enable email drafts and follow-ups in Max?▼

Run max settings email get with your connectedAccountId first, then update with draftEnabled or followupEnabled set to true. Both require categorizationEnabled to be true, otherwise the update is rejected with a 400 error.

Where do I find the connectedAccountId for max settings email?▼

Run max integrations list and find the id of a gmail or outlook integration. That id is passed as the argument to max settings email get or update for per-mailbox settings.

Why did my email labels disappear after a settings update?▼

The labels field is a full replacement, not a merge. Any existing label whose id you omit gets deleted, and omitting a system label returns a 400. Omit the labels key entirely when updating other email fields.

Can I configure Studio agents with max settings?▼

No. max settings only manages your personal Max assistant preferences. Studio agent configuration is account-scoped and lives on the frontline binary under frontline agents agent-setting, a separate surface.