# Tools reference

> Every tool of the Maylee MCP server, grouped by toolset, generated from the server's own tool definitions.

Source: https://docs.maylee.app/mcp/tools

The server exposes 69 tools in five toolsets. This reference is generated from the tool definitions of the server itself: names, descriptions, parameters and output fields are exactly what your assistant receives in `tools/list`.

Each tool has a permission: **Read**, **Organize and draft** (`write`) or **Send**. A connection only lists the tools its [permissions](/mcp/permissions) allow, and tools marked **OAuth only** act for a person, so they are hidden for API keys. Every tool returns `structuredContent` matching its output schema plus the same JSON as text; errors come back as `isError: true` with `{ "code", "error", "details" }`, so the model can read the message and fix its call.

### Reference (`reference`, 1 tool)

get_reference: label colors, view icons, the filter grammar, rule options, limits and safety rules.

| Tool | Permission | What it does |
| --- | --- | --- |
| [get_reference](/mcp/tools/reference.md#get_reference) | Read | Get Maylee reference data |

### Account (`account`, 10 tools)

Workspace and connection, mailboxes, sync, unread counts, contacts, reply reminders, notification settings, timezone.

| Tool | Permission | What it does |
| --- | --- | --- |
| [get_workspace](/mcp/tools/account.md#get_workspace) | Read | Get workspace and connection |
| [list_mailboxes](/mcp/tools/account.md#list_mailboxes) | Read | List connected mailboxes |
| [sync_mailbox](/mcp/tools/account.md#sync_mailbox) | Organize and draft | Check a mailbox for new email now |
| [get_unread_counts](/mcp/tools/account.md#get_unread_counts) | Read | Get unread counts |
| [suggest_contacts](/mcp/tools/account.md#suggest_contacts) | Read | Suggest contacts |
| [list_reply_reminders](/mcp/tools/account.md#list_reply_reminders) | Read, OAuth only | List reply reminders |
| [dismiss_reply_reminders](/mcp/tools/account.md#dismiss_reply_reminders) | Organize and draft, OAuth only | Dismiss reply reminders |
| [get_notification_settings](/mcp/tools/account.md#get_notification_settings) | Read, OAuth only | Get notification settings |
| [update_notification_settings](/mcp/tools/account.md#update_notification_settings) | Organize and draft, OAuth only | Update notification settings |
| [set_workspace_timezone](/mcp/tools/account.md#set_workspace_timezone) | Organize and draft | Set the workspace timezone |

### Emails (`emails`, 14 tools)

List, search and read emails, threads and attachments; mark read, pin, move, trash, label; waiting for reply; unsubscribe.

| Tool | Permission | What it does |
| --- | --- | --- |
| [list_emails](/mcp/tools/emails.md#list_emails) | Read | List emails |
| [search_emails](/mcp/tools/emails.md#search_emails) | Read | Search emails |
| [get_email](/mcp/tools/emails.md#get_email) | Read | Get email details |
| [get_thread](/mcp/tools/emails.md#get_thread) | Read | Read a conversation |
| [get_attachment](/mcp/tools/emails.md#get_attachment) | Read | Read an attachment |
| [mark_emails_read](/mcp/tools/emails.md#mark_emails_read) | Organize and draft | Mark emails read or unread |
| [pin_emails](/mcp/tools/emails.md#pin_emails) | Organize and draft | Pin or unpin emails |
| [move_emails](/mcp/tools/emails.md#move_emails) | Organize and draft | Move emails to Inbox or Spam |
| [trash_emails](/mcp/tools/emails.md#trash_emails) | Organize and draft | Move emails to Trash |
| [apply_label_to_emails](/mcp/tools/emails.md#apply_label_to_emails) | Organize and draft | Add a label to emails |
| [remove_label_from_emails](/mcp/tools/emails.md#remove_label_from_emails) | Organize and draft | Remove a label from emails |
| [dismiss_waiting_for_reply](/mcp/tools/emails.md#dismiss_waiting_for_reply) | Organize and draft | Stop waiting for a reply |
| [get_unsubscribe_options](/mcp/tools/emails.md#get_unsubscribe_options) | Read | Check how to unsubscribe |
| [unsubscribe](/mcp/tools/emails.md#unsubscribe) | Send | Unsubscribe from a sender |

### Compose (`compose`, 22 tools)

Drafts, replies, forwards, sending, scheduling, attachments, automatic replies, Magic Reply, signatures, snippets.

| Tool | Permission | What it does |
| --- | --- | --- |
| [get_draft](/mcp/tools/compose.md#get_draft) | Read | Get a draft |
| [create_draft](/mcp/tools/compose.md#create_draft) | Organize and draft | Create a draft |
| [update_draft](/mcp/tools/compose.md#update_draft) | Organize and draft | Edit a draft |
| [delete_draft](/mcp/tools/compose.md#delete_draft) | Organize and draft | Delete a draft |
| [send_draft](/mcp/tools/compose.md#send_draft) | Send | Send a draft |
| [send_email](/mcp/tools/compose.md#send_email) | Send | Send a new email |
| [draft_reply](/mcp/tools/compose.md#draft_reply) | Organize and draft | Draft a reply |
| [draft_forward](/mcp/tools/compose.md#draft_forward) | Organize and draft | Draft a forward |
| [schedule_draft](/mcp/tools/compose.md#schedule_draft) | Send | Schedule a draft |
| [cancel_scheduled_send](/mcp/tools/compose.md#cancel_scheduled_send) | Organize and draft | Cancel a scheduled send |
| [add_draft_attachment](/mcp/tools/compose.md#add_draft_attachment) | Organize and draft | Attach a file to a draft |
| [remove_draft_attachment](/mcp/tools/compose.md#remove_draft_attachment) | Organize and draft | Remove an attachment from a draft |
| [cancel_auto_reply](/mcp/tools/compose.md#cancel_auto_reply) | Organize and draft | Cancel a pending auto-reply |
| [generate_magic_reply](/mcp/tools/compose.md#generate_magic_reply) | Organize and draft | Suggest a reply in the user's style |
| [list_signatures](/mcp/tools/compose.md#list_signatures) | Read | List signatures |
| [create_signature](/mcp/tools/compose.md#create_signature) | Organize and draft | Create a signature |
| [update_signature](/mcp/tools/compose.md#update_signature) | Organize and draft | Edit a signature |
| [delete_signature](/mcp/tools/compose.md#delete_signature) | Organize and draft | Delete a signature |
| [list_snippets](/mcp/tools/compose.md#list_snippets) | Read | List snippets |
| [create_snippet](/mcp/tools/compose.md#create_snippet) | Organize and draft | Create a snippet |
| [update_snippet](/mcp/tools/compose.md#update_snippet) | Organize and draft | Edit a snippet |
| [delete_snippet](/mcp/tools/compose.md#delete_snippet) | Organize and draft | Delete a snippet |

### Configuration (`config`, 22 tools)

Labels, AI label rules, views, inbox filters, auto-forward rules.

| Tool | Permission | What it does |
| --- | --- | --- |
| [list_labels](/mcp/tools/config.md#list_labels) | Read | List labels |
| [create_label](/mcp/tools/config.md#create_label) | Organize and draft | Create a label |
| [update_label](/mcp/tools/config.md#update_label) | Organize and draft | Edit a label |
| [delete_label](/mcp/tools/config.md#delete_label) | Organize and draft | Delete a label |
| [list_ai_label_rules](/mcp/tools/config.md#list_ai_label_rules) | Read | List AI label rules |
| [create_ai_label_rule](/mcp/tools/config.md#create_ai_label_rule) | Organize and draft | Create an AI label rule |
| [update_ai_label_rule](/mcp/tools/config.md#update_ai_label_rule) | Organize and draft | Edit an AI label rule |
| [delete_ai_label_rule](/mcp/tools/config.md#delete_ai_label_rule) | Organize and draft | Delete an AI label rule |
| [classify_existing_emails](/mcp/tools/config.md#classify_existing_emails) | Organize and draft | Apply AI labels to existing emails |
| [list_views](/mcp/tools/config.md#list_views) | Read | List views |
| [create_view](/mcp/tools/config.md#create_view) | Organize and draft | Create a view |
| [update_view](/mcp/tools/config.md#update_view) | Organize and draft | Edit a view |
| [delete_view](/mcp/tools/config.md#delete_view) | Organize and draft | Delete a view |
| [list_inbox_filters](/mcp/tools/config.md#list_inbox_filters) | Read | List inbox filters |
| [create_inbox_filter](/mcp/tools/config.md#create_inbox_filter) | Organize and draft | Create an inbox filter |
| [update_inbox_filter](/mcp/tools/config.md#update_inbox_filter) | Organize and draft | Edit an inbox filter |
| [delete_inbox_filter](/mcp/tools/config.md#delete_inbox_filter) | Organize and draft | Delete an inbox filter |
| [list_auto_forward_rules](/mcp/tools/config.md#list_auto_forward_rules) | Read | List auto-forward rules |
| [create_auto_forward_rule](/mcp/tools/config.md#create_auto_forward_rule) | Send | Create an auto-forward rule |
| [update_auto_forward_rule](/mcp/tools/config.md#update_auto_forward_rule) | Send | Edit an auto-forward rule |
| [delete_auto_forward_rule](/mcp/tools/config.md#delete_auto_forward_rule) | Send | Delete an auto-forward rule |
| [get_auto_forward_logs](/mcp/tools/config.md#get_auto_forward_logs) | Read | Get auto-forward history |

## Reading a tool page

* **Confirm**: the tool refuses to act without `confirm: true`, always or in some cases (see [Confirmations](/mcp/permissions#confirmations)).
* **Idempotency key**: `required` on sends, `optional` on creations. Reuse the same key only to retry the same call after a timeout.
* **Hourly budget**: the tool counts against one of the hourly safety budgets of the connection (see [Limits](/mcp/limits)).
* **Hints** are the MCP tool annotations: `read-only`, `destructive`, `idempotent`, `open world` (acts outside the mailbox).