Permission levels

After this page, you know what each level lets the agent do, and how you change a level. A level is a number from 0 to 5 that says what the agent may do with the mail of an account. The agent is the AI (artificial intelligence) program that uses the tools of email-mcp.

The levels

Each account has its own level for each area. This version has the mail area only. A level includes every level under it. The Trash is the folder of deleted mail. The column “Name on the web page” shows the name that you see in the settings of an account.

Level Mail Name on the web page
0 Off Off
1 Read Read
2 + Organize (flags, tags, move, create folders and tags) Organize
3 + Draft Draft
4 + Send, reply, forward Send
5 + Move to Trash Delete

The web page names level 5 Delete. It means that the agent can move mail to the Trash (the folder of deleted mail). No tool deletes mail for good.

A new account

A new account starts at Mail 4, with Confirm sends and Confirm deletes on. Mail 4 is level 4, named Send on the web page. Confirm sends asks you before the agent sends a message. Confirm deletes asks you before the agent moves mail to the Trash. So:

  • reading, organizing and writing drafts (messages that are saved but not sent) happen without questions;
  • every send asks you first;
  • moving mail to the Trash needs level 5. Mail servers differ, so email-mcp may not recognize every Trash folder. The exceptions are drafts. At level 3 discard_draft moves a draft to the Trash without a question. When the agent sends a saved draft (send_message with draft_ref, the reference of the draft), email-mcp moves that draft to the Trash after the mail server takes the message (level 4 is enough). Neither counts toward the daily Trash limit (see Limits that stay on).

The page Confirmations explains the two switches.

Change a level

Do these steps in the browser where you signed in with email-mcp setup. The web pages run only while an email-mcp program serves them: if they are closed, see Open the pages again first. Each button name is written as the page shows it.

  1. Click Accounts in the menu.

  2. Click Permissions and settings on the account. The page shows “Mail is now at level” and the name of the level.

    The settings page of an account. The group Permissions shows the Mail level list with 4 Send chosen, and the box Confirm sends. The group Limits and the button Save follow.
  3. Choose the level in the Mail level list. The list shows each level with its number and its name, such as “4 Send”.

  4. Click Save.

A save needs one more box when it turns off Confirm sends, when it raises the level to Send or above while Confirm sends is off, and when it leaves both confirmations off. See Full autonomy, limits and settings.

Turn off the access of the agent

Choose 0 Off in the Mail level list, and click Save. Level 0 stops the agent from using this mail account. A send that waits in the queue is checked again each time it is about to go out. If the level of the account no longer allows sending, the send fails and does not go out, even if you raise the level again later. You can also cancel a queued send yourself. See Activity and undo.

Only you change a level

Only you can change a level, and only on the settings page of the account in the browser. The agent cannot change permissions through any tool. It can call request_permission_change, which only returns a link to that page. The link does not change the form. The page shows the requested level apart from the form, says what that level allows, and offers a button Apply requested level N. Save never applies a requested level.

The requested level shows in a box at the top of the page. It starts with “A request asks to set mail to level” and the number and the name of the level, and it says “Nothing has changed yet.” Apply the level only if you agree.

This holds for an agent that can only call the tools of email-mcp. It does not hold for an agent that runs shell commands as you, or for an agent that controls your browser. The page Security says more.