Files
handbook/docker/packages/google_mail/mcp-tools.generated.json
T

2979 lines
100 KiB
JSON
Raw Normal View History

2026-06-24 12:44:34 -07:00
{
"schema_version": "v1",
"tools": [
{
"name": "add_contact",
"description": "Add a new contact to the address book.\n\nArgs:\n email: Email address of the contact\n name: Display name of the contact",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email": {
"format": "email",
"type": "string"
},
"name": {
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "add_group",
"description": "Add a new addressable contact group.\n\nArgs:\n email: Email address of the group\n name: Display name of the group\n members: Contact emails included in the group",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email": {
"format": "email",
"type": "string"
},
"name": {
"type": "string"
},
"members": {
"description": "Contact emails included in the group.",
"items": {
"format": "email",
"type": "string"
},
"minItems": 1,
"type": "array"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email",
"name",
"members"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "cancel_scheduled_email",
"description": "Cancel a scheduled email. The email is permanently removed.\n\nArgs:\n email_id: ID of the scheduled email to cancel",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email_id": {
"description": "Email ID.",
"minLength": 1,
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email_id"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "create_folder",
"description": "Create a new custom folder.\n\nArgs:\n folder_name: Name of the folder to create\n\nReturns:\n JSON with creation status.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"folder_name": {
"description": "Folder name.",
"minLength": 1,
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"folder_name"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "delete_contact",
"description": "Remove a contact from the address book.\n\nArgs:\n email: Email address of the contact to delete",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email": {
"format": "email",
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "delete_draft",
"description": "Delete a draft.\n\nArgs:\n draft_id: ID of the draft to delete\n\nReturns:\n JSON with deletion status.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"draft_id": {
"description": "Draft ID.",
"minLength": 1,
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"draft_id"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "delete_emails",
"description": "Delete one or more emails.\n\nBy default, moves them to Trash. Use permanent=True to skip Trash.\nDeleting from Trash permanently deletes. Partial success is allowed \u2014\nemails that don't exist surface in the errors list but don't abort the batch.\n\nArgs:\n email_ids: IDs of the emails to delete (pass a single-element list for one)\n permanent: Permanently delete (skip Trash)\n\nReturns:\n JSON with per-id status and a deleted/failed count.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email_ids": {
"description": "One or more email IDs.",
"items": {
"description": "Email ID.",
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"permanent": {
"default": false,
"type": "boolean"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email_ids"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "delete_folder",
"description": "Delete a custom folder.\n\nSystem folders (INBOX, Sent, Drafts, Trash) cannot be deleted.\nEmails in the deleted folder are moved to INBOX.\n\nArgs:\n folder_name: Name of the folder to delete\n\nReturns:\n JSON with deletion status.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"folder_name": {
"description": "Folder name.",
"minLength": 1,
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"folder_name"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "delete_group",
"description": "Remove a contact group from the address book.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email": {
"format": "email",
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "download_attachment",
"description": "Download an attachment from an email.\n\nReturns the attachment content as base64-encoded data.\n\nArgs:\n email_id: ID of the email\n filename: Name of the attachment file\n\nReturns:\n JSON with attachment data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email_id": {
"description": "Email ID.",
"minLength": 1,
"type": "string"
},
"filename": {
"description": "Attachment filename.",
"minLength": 1,
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email_id",
"filename"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "edit_contact",
"description": "Update an existing contact's name.\n\nArgs:\n email: Email address of the contact to update (lookup key)\n name: New display name (optional, omit to keep current)",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email": {
"format": "email",
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "edit_group",
"description": "Update an existing contact group.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email": {
"format": "email",
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"members": {
"anyOf": [
{
"description": "Contact emails included in the group.",
"items": {
"format": "email",
"type": "string"
},
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "export_state",
"description": "Export the full mailbox state as JSON.\n\nSingle-mailbox worlds emit ``MailboxData``; multi-mailbox worlds emit\n``MultiMailboxData``. Round-trips with import_state.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"anyOf": [
{
"additionalProperties": false,
"description": "Root schema for mock mailbox data.",
"properties": {
"mailbox": {
"additionalProperties": false,
"description": "Identity of the mailbox owner",
"properties": {
"email": {
"description": "Email address of the mailbox owner",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the mailbox owner",
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"contacts": {
"description": "Valid contacts",
"items": {
"additionalProperties": false,
"description": "A valid email contact in the closed-world simulation.",
"properties": {
"email": {
"description": "Email address of the contact",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the contact",
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"type": "array"
},
"groups": {
"description": "Addressable contact groups",
"items": {
"additionalProperties": false,
"description": "An addressable email group in the closed-world simulation.",
"properties": {
"email": {
"description": "Email address of the group",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the group",
"type": "string"
},
"members": {
"description": "Contact emails included in the group",
"items": {
"format": "email",
"type": "string"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"email",
"name",
"members"
],
"type": "object"
},
"type": "array"
},
"folders": {
"description": "Custom folders",
"items": {
"additionalProperties": false,
"description": "A custom email folder.",
"properties": {
"name": {
"description": "Folder name",
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"emails": {
"description": "All emails (including drafts in Drafts folder)",
"items": {
"additionalProperties": false,
"description": "An email message in the mailbox.",
"properties": {
"email_id": {
"description": "Unique email identifier",
"minLength": 1,
"type": "string"
},
"folder": {
"description": "Folder containing the email",
"minLength": 1,
"type": "string"
},
"subject": {
"description": "Email subject line",
"type": "string"
},
"from_addr": {
"description": "Sender email address",
"format": "email",
"type": "string"
},
"to_addr": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"description": "Recipient(s), comma-separated string or list of strings"
},
"cc_addr": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"default": null,
"description": "CC recipients, comma-separated string or list of strings"
},
"bcc_addr": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"default": null,
"description": "BCC recipients, comma-separated string or list of strings"
},
"date": {
"description": "Date/time the email was sent",
"format": "date-time",
"type": "string"
},
"message_id": {
"description": "RFC 2822 Message-ID",
"minLength": 1,
"type": "string"
},
"in_reply_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Message-ID of the email this is replying to"
},
"body_text": {
"description": "Plain text body",
"type": "string"
},
"body_html": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "HTML body"
},
"is_read": {
"default": false,
"description": "Whether the email has been read",
"type": "boolean"
},
"is_important": {
"default": false,
"description": "Whether the email is marked important",
"type": "boolean"
},
"labels": {
"description": "Search labels attached to the email",
"items": {
"type": "string"
},
"type": "array"
},
"attachments": {
"description": "Email attachments",
"items": {
"additionalProperties": false,
"description": "An email attachment with base64-encoded content.",
"properties": {
"filename": {
"description": "Filename of the attachment",
"minLength": 1,
"type": "string"
},
"content_type": {
"description": "MIME type",
"type": "string"
},
"content_base64": {
"contentEncoding": "base64",
"description": "Base64-encoded file content",
"type": "string"
}
},
"required": [
"filename",
"content_type",
"content_base64"
],
"type": "object"
},
"type": "array"
},
"scheduled_time": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Scheduled send time (None if not scheduled)"
}
},
"required": [
"email_id",
"folder",
"subject",
"from_addr",
"to_addr",
"date",
"message_id",
"body_text"
],
"type": "object"
},
"type": "array"
},
"next_email_id": {
"default": 1,
"description": "Next email ID counter",
"minimum": 1,
"type": "integer"
}
},
"required": [
"mailbox"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Root schema for multi-mailbox Google Mail state.",
"properties": {
"mailboxes": {
"additionalProperties": {
"additionalProperties": false,
"description": "Root schema for mock mailbox data.",
"properties": {
"mailbox": {
"additionalProperties": false,
"description": "Identity of the mailbox owner",
"properties": {
"email": {
"description": "Email address of the mailbox owner",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the mailbox owner",
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"contacts": {
"description": "Valid contacts",
"items": {
"additionalProperties": false,
"description": "A valid email contact in the closed-world simulation.",
"properties": {
"email": {
"description": "Email address of the contact",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the contact",
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"type": "array"
},
"groups": {
"description": "Addressable contact groups",
"items": {
"additionalProperties": false,
"description": "An addressable email group in the closed-world simulation.",
"properties": {
"email": {
"description": "Email address of the group",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the group",
"type": "string"
},
"members": {
"description": "Contact emails included in the group",
"items": {
"format": "email",
"type": "string"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"email",
"name",
"members"
],
"type": "object"
},
"type": "array"
},
"folders": {
"description": "Custom folders",
"items": {
"additionalProperties": false,
"description": "A custom email folder.",
"properties": {
"name": {
"description": "Folder name",
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"emails": {
"description": "All emails (including drafts in Drafts folder)",
"items": {
"additionalProperties": false,
"description": "An email message in the mailbox.",
"properties": {
"email_id": {
"description": "Unique email identifier",
"minLength": 1,
"type": "string"
},
"folder": {
"description": "Folder containing the email",
"minLength": 1,
"type": "string"
},
"subject": {
"description": "Email subject line",
"type": "string"
},
"from_addr": {
"description": "Sender email address",
"format": "email",
"type": "string"
},
"to_addr": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"description": "Recipient(s), comma-separated string or list of strings"
},
"cc_addr": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"default": null,
"description": "CC recipients, comma-separated string or list of strings"
},
"bcc_addr": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"default": null,
"description": "BCC recipients, comma-separated string or list of strings"
},
"date": {
"description": "Date/time the email was sent",
"format": "date-time",
"type": "string"
},
"message_id": {
"description": "RFC 2822 Message-ID",
"minLength": 1,
"type": "string"
},
"in_reply_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Message-ID of the email this is replying to"
},
"body_text": {
"description": "Plain text body",
"type": "string"
},
"body_html": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "HTML body"
},
"is_read": {
"default": false,
"description": "Whether the email has been read",
"type": "boolean"
},
"is_important": {
"default": false,
"description": "Whether the email is marked important",
"type": "boolean"
},
"labels": {
"description": "Search labels attached to the email",
"items": {
"type": "string"
},
"type": "array"
},
"attachments": {
"description": "Email attachments",
"items": {
"additionalProperties": false,
"description": "An email attachment with base64-encoded content.",
"properties": {
"filename": {
"description": "Filename of the attachment",
"minLength": 1,
"type": "string"
},
"content_type": {
"description": "MIME type",
"type": "string"
},
"content_base64": {
"contentEncoding": "base64",
"description": "Base64-encoded file content",
"type": "string"
}
},
"required": [
"filename",
"content_type",
"content_base64"
],
"type": "object"
},
"type": "array"
},
"scheduled_time": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Scheduled send time (None if not scheduled)"
}
},
"required": [
"email_id",
"folder",
"subject",
"from_addr",
"to_addr",
"date",
"message_id",
"body_text"
],
"type": "object"
},
"type": "array"
},
"next_email_id": {
"default": 1,
"description": "Next email ID counter",
"minimum": 1,
"type": "integer"
}
},
"required": [
"mailbox"
],
"type": "object"
},
"description": "Mailbox state keyed by mailbox identifier.",
"minProperties": 1,
"propertyNames": {
"description": "Mailbox identifier",
"minLength": 1
},
"type": "object"
}
},
"required": [
"mailboxes"
],
"type": "object"
}
]
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "forward_email",
"description": "Forward an email to one or more recipients.\n\nIncludes the original message content and any attachments.\n\nArgs:\n email_id: ID of the email to forward\n to: Recipient(s) to forward to, comma-separated\n body: Additional message (optional)\n\nReturns:\n JSON with sent status and forwarded email summary.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email_id": {
"description": "Email ID.",
"minLength": 1,
"type": "string"
},
"to": {
"type": "string"
},
"body": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email_id",
"to"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "get_contacts",
"description": "Get all contacts.\n\nReturns the person contacts in your address book. Groups are available\nthrough get_groups.\n\nReturns:\n JSON with contact list.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "get_drafts",
"description": "Get all drafts with pagination.\n\nArgs:\n page: Page number (1-indexed)\n page_size: Results per page (max 100)\n\nReturns:\n JSON with drafts and pagination info.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page": {
"default": 1,
"description": "Page number, starting at 1.",
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Number of results per page.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "get_emails",
"description": "Get emails from the mailbox, optionally filtered by folder.\n\nReturns a paginated list of emails sorted by date (newest first).\n\nArgs:\n folder: Folder to filter by (optional)\n page: Page number (1-indexed)\n page_size: Results per page (max 100)\n\nReturns:\n JSON with emails and pagination info.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"folder": {
"anyOf": [
{
"description": "Folder name.",
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"page": {
"default": 1,
"description": "Page number, starting at 1.",
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Number of results per page.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "get_folders",
"description": "Get all folders with message counts.\n\nReturns system folders (INBOX, Sent, Drafts, Trash) and custom folders.\n\nReturns:\n JSON with folder list including name, total, unread, is_system.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "get_groups",
"description": "Get all addressable contact groups.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "get_mailbox_stats",
"description": "Get overall mailbox statistics.\n\nReturns owner info, total counts, and per-folder breakdown.\n\nReturns:\n JSON with comprehensive mailbox statistics.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "get_scheduled_emails",
"description": "Get list of emails scheduled for later delivery.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page": {
"default": 1,
"description": "Page number, starting at 1.",
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Number of results per page.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "get_unread_count",
"description": "Get unread email count for folders.\n\nArgs:\n folder: Specific folder (optional)\n\nReturns:\n JSON with unread counts per folder.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"folder": {
"anyOf": [
{
"description": "Folder name.",
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "import_state",
"description": "Replace the full mailbox state with the provided JSON.\n\nAccepts either the flat MailboxData shape (loaded into the ``default``\nmailbox) or the multi-mailbox wrapper (``{\"mailboxes\": {mailbox_id: ...}}``).\nFor synthetic-data injection and test setup.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"state": {
"anyOf": [
{
"additionalProperties": false,
"description": "Root schema for mock mailbox data.",
"properties": {
"mailbox": {
"additionalProperties": false,
"description": "Identity of the mailbox owner",
"properties": {
"email": {
"description": "Email address of the mailbox owner",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the mailbox owner",
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"contacts": {
"description": "Valid contacts",
"items": {
"additionalProperties": false,
"description": "A valid email contact in the closed-world simulation.",
"properties": {
"email": {
"description": "Email address of the contact",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the contact",
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"type": "array"
},
"groups": {
"description": "Addressable contact groups",
"items": {
"additionalProperties": false,
"description": "An addressable email group in the closed-world simulation.",
"properties": {
"email": {
"description": "Email address of the group",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the group",
"type": "string"
},
"members": {
"description": "Contact emails included in the group",
"items": {
"format": "email",
"type": "string"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"email",
"name",
"members"
],
"type": "object"
},
"type": "array"
},
"folders": {
"description": "Custom folders",
"items": {
"additionalProperties": false,
"description": "A custom email folder.",
"properties": {
"name": {
"description": "Folder name",
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"emails": {
"description": "All emails (including drafts in Drafts folder)",
"items": {
"additionalProperties": false,
"description": "An email message in the mailbox.",
"properties": {
"email_id": {
"description": "Unique email identifier",
"minLength": 1,
"type": "string"
},
"folder": {
"description": "Folder containing the email",
"minLength": 1,
"type": "string"
},
"subject": {
"description": "Email subject line",
"type": "string"
},
"from_addr": {
"description": "Sender email address",
"format": "email",
"type": "string"
},
"to_addr": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"description": "Recipient(s), comma-separated string or list of strings"
},
"cc_addr": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"default": null,
"description": "CC recipients, comma-separated string or list of strings"
},
"bcc_addr": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"default": null,
"description": "BCC recipients, comma-separated string or list of strings"
},
"date": {
"description": "Date/time the email was sent",
"format": "date-time",
"type": "string"
},
"message_id": {
"description": "RFC 2822 Message-ID",
"minLength": 1,
"type": "string"
},
"in_reply_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Message-ID of the email this is replying to"
},
"body_text": {
"description": "Plain text body",
"type": "string"
},
"body_html": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "HTML body"
},
"is_read": {
"default": false,
"description": "Whether the email has been read",
"type": "boolean"
},
"is_important": {
"default": false,
"description": "Whether the email is marked important",
"type": "boolean"
},
"labels": {
"description": "Search labels attached to the email",
"items": {
"type": "string"
},
"type": "array"
},
"attachments": {
"description": "Email attachments",
"items": {
"additionalProperties": false,
"description": "An email attachment with base64-encoded content.",
"properties": {
"filename": {
"description": "Filename of the attachment",
"minLength": 1,
"type": "string"
},
"content_type": {
"description": "MIME type",
"type": "string"
},
"content_base64": {
"contentEncoding": "base64",
"description": "Base64-encoded file content",
"type": "string"
}
},
"required": [
"filename",
"content_type",
"content_base64"
],
"type": "object"
},
"type": "array"
},
"scheduled_time": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Scheduled send time (None if not scheduled)"
}
},
"required": [
"email_id",
"folder",
"subject",
"from_addr",
"to_addr",
"date",
"message_id",
"body_text"
],
"type": "object"
},
"type": "array"
},
"next_email_id": {
"default": 1,
"description": "Next email ID counter",
"minimum": 1,
"type": "integer"
}
},
"required": [
"mailbox"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Root schema for multi-mailbox Google Mail state.",
"properties": {
"mailboxes": {
"additionalProperties": {
"additionalProperties": false,
"description": "Root schema for mock mailbox data.",
"properties": {
"mailbox": {
"additionalProperties": false,
"description": "Identity of the mailbox owner",
"properties": {
"email": {
"description": "Email address of the mailbox owner",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the mailbox owner",
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"contacts": {
"description": "Valid contacts",
"items": {
"additionalProperties": false,
"description": "A valid email contact in the closed-world simulation.",
"properties": {
"email": {
"description": "Email address of the contact",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the contact",
"type": "string"
}
},
"required": [
"email",
"name"
],
"type": "object"
},
"type": "array"
},
"groups": {
"description": "Addressable contact groups",
"items": {
"additionalProperties": false,
"description": "An addressable email group in the closed-world simulation.",
"properties": {
"email": {
"description": "Email address of the group",
"format": "email",
"type": "string"
},
"name": {
"description": "Display name of the group",
"type": "string"
},
"members": {
"description": "Contact emails included in the group",
"items": {
"format": "email",
"type": "string"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"email",
"name",
"members"
],
"type": "object"
},
"type": "array"
},
"folders": {
"description": "Custom folders",
"items": {
"additionalProperties": false,
"description": "A custom email folder.",
"properties": {
"name": {
"description": "Folder name",
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"emails": {
"description": "All emails (including drafts in Drafts folder)",
"items": {
"additionalProperties": false,
"description": "An email message in the mailbox.",
"properties": {
"email_id": {
"description": "Unique email identifier",
"minLength": 1,
"type": "string"
},
"folder": {
"description": "Folder containing the email",
"minLength": 1,
"type": "string"
},
"subject": {
"description": "Email subject line",
"type": "string"
},
"from_addr": {
"description": "Sender email address",
"format": "email",
"type": "string"
},
"to_addr": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"description": "Recipient(s), comma-separated string or list of strings"
},
"cc_addr": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"default": null,
"description": "CC recipients, comma-separated string or list of strings"
},
"bcc_addr": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"items": {
"format": "email",
"type": "string"
},
"type": "array"
}
],
"default": null,
"description": "BCC recipients, comma-separated string or list of strings"
},
"date": {
"description": "Date/time the email was sent",
"format": "date-time",
"type": "string"
},
"message_id": {
"description": "RFC 2822 Message-ID",
"minLength": 1,
"type": "string"
},
"in_reply_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Message-ID of the email this is replying to"
},
"body_text": {
"description": "Plain text body",
"type": "string"
},
"body_html": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "HTML body"
},
"is_read": {
"default": false,
"description": "Whether the email has been read",
"type": "boolean"
},
"is_important": {
"default": false,
"description": "Whether the email is marked important",
"type": "boolean"
},
"labels": {
"description": "Search labels attached to the email",
"items": {
"type": "string"
},
"type": "array"
},
"attachments": {
"description": "Email attachments",
"items": {
"additionalProperties": false,
"description": "An email attachment with base64-encoded content.",
"properties": {
"filename": {
"description": "Filename of the attachment",
"minLength": 1,
"type": "string"
},
"content_type": {
"description": "MIME type",
"type": "string"
},
"content_base64": {
"contentEncoding": "base64",
"description": "Base64-encoded file content",
"type": "string"
}
},
"required": [
"filename",
"content_type",
"content_base64"
],
"type": "object"
},
"type": "array"
},
"scheduled_time": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Scheduled send time (None if not scheduled)"
}
},
"required": [
"email_id",
"folder",
"subject",
"from_addr",
"to_addr",
"date",
"message_id",
"body_text"
],
"type": "object"
},
"type": "array"
},
"next_email_id": {
"default": 1,
"description": "Next email ID counter",
"minimum": 1,
"type": "integer"
}
},
"required": [
"mailbox"
],
"type": "object"
},
"description": "Mailbox state keyed by mailbox identifier.",
"minProperties": 1,
"propertyNames": {
"description": "Mailbox identifier",
"minLength": 1
},
"type": "object"
}
},
"required": [
"mailboxes"
],
"type": "object"
}
]
}
},
"required": [
"state"
],
"type": "object"
},
"outputSchema": {
"additionalProperties": true,
"type": "object"
}
},
{
"name": "list_mailboxes",
"description": "List all available mailboxes.\n\nReturns:\n JSON with mailbox IDs, email addresses, and names.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "mark_emails",
"description": "Mark emails as read/unread or important/not important.\n\nArgs:\n email_ids: List of email IDs to mark\n is_read: Set read status (optional)\n is_important: Set important status (optional)\n\nReturns:\n JSON with number of emails updated.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email_ids": {
"description": "One or more email IDs.",
"items": {
"description": "Email ID.",
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"is_read": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
},
"is_important": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email_ids"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "move_emails",
"description": "Move one or more emails to a different folder.\n\nPartial success is allowed \u2014 emails or folders that don't exist surface\nin the errors list but don't abort the batch.\n\nArgs:\n email_ids: IDs of the emails to move (pass a single-element list for one)\n target_folder: Name of the target folder\n\nReturns:\n JSON with per-id status and a moved/failed count.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email_ids": {
"description": "One or more email IDs.",
"items": {
"description": "Email ID.",
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"target_folder": {
"description": "Folder name.",
"minLength": 1,
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email_ids",
"target_folder"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "read_email",
"description": "Read an email and mark it as read.\n\nReturns the full email content including body and attachments.\n\nArgs:\n email_id: ID of the email to read\n\nReturns:\n JSON with full email details.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email_id": {
"description": "Email ID.",
"minLength": 1,
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email_id"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "reply_email",
"description": "Reply to an email.\n\nCreates a reply with proper subject prefix and recipients.\n\nArgs:\n email_id: ID of the email to reply to\n body: Reply body text\n html_body: HTML body (optional)\n reply_all: Reply to all recipients\n\nReturns:\n JSON with sent status and reply email summary.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"email_id": {
"description": "Email ID.",
"minLength": 1,
"type": "string"
},
"body": {
"type": "string"
},
"html_body": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"reply_all": {
"default": false,
"type": "boolean"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"email_id",
"body"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "save_draft",
"description": "Save a new email draft.\n\nArgs:\n subject: Draft subject\n body: Draft body\n html_body: HTML body (optional)\n to: Recipient(s), comma-separated (optional)\n cc: CC recipient(s), comma-separated (optional)\n bcc: BCC recipient(s), comma-separated (optional)\n\nReturns:\n JSON with saved draft details.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"subject": {
"default": "",
"type": "string"
},
"body": {
"default": "",
"type": "string"
},
"html_body": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"cc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"bcc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "schedule_email",
"description": "Schedule an email for later delivery.\n\nArgs:\n to: Recipient(s), comma-separated\n subject: Email subject\n body: Plain text email body\n scheduled_time: ISO 8601 datetime for when to send (e.g., '2024-12-25T09:00:00Z')\n html_body: HTML body (optional)\n cc: CC recipient(s), comma-separated (optional)\n bcc: BCC recipient(s), comma-separated (optional)",
"inputSchema": {
"additionalProperties": false,
"properties": {
"to": {
"type": "string"
},
"subject": {
"type": "string"
},
"body": {
"type": "string"
},
"scheduled_time": {
"description": "ISO 8601 scheduled send time.",
"format": "date-time",
"type": "string"
},
"html_body": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"cc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"bcc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"to",
"subject",
"body",
"scheduled_time"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "search_contacts",
"description": "Search contacts by name or email address (case-insensitive).\n\nArgs:\n query: Search string to match against contact name or email",
"inputSchema": {
"additionalProperties": false,
"properties": {
"query": {
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "search_emails",
"description": "Search emails by query string. Supports Gmail-style operators.\n\nBare words are ANDed together and matched across subject, body, from,\nand to. Double-quoted segments require exact adjacency. Combine freely,\ne.g. `from:alice after:2026/03/01 invoice`.\n\nOperators:\n from:alice match sender substring (alice@... hits this)\n to:bob match to recipient substring (strict; use cc:/bcc: for other fields)\n cc:alice / bcc:alice match cc/bcc recipient substring\n subject:meeting match subject substring\n has:attachment messages with one or more attachments\n filename:agenda.pdf match attachment filename substring\n is:unread state filters: unread, read, important\n in:sent exact folder match\n label:client exact label match when labels exist; otherwise folder-style match\n \"exact phrase\" match a contiguous phrase\n -term exclude messages containing term (works with operators, e.g. -from:bob)\n invoice OR billing boolean OR (uppercase; lowercase 'or' is literal)\n before:2026/04/01 messages strictly before date (YYYY/MM/DD or YYYY-MM-DD)\n after:2026/04/01 messages on or after date\n newer_than:7d messages within last N days (d), months (m = 30d), or years (y = 365d)\n older_than:1y messages older than N d|m|y\n\nParenthesized boolean grouping is not supported; `OR` joins adjacent terms only.\nUnsupported or malformed search syntax is reported in a `warnings` array\nwhile preserving best-effort search behavior.\n\nArgs:\n query: Search query (supports the operators above).\n folder: Folder to limit search (optional).\n page: Page number (1-indexed).\n page_size: Results per page (max 100).\n\nReturns:\n JSON with matching emails and pagination info.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"query": {
"type": "string"
},
"folder": {
"anyOf": [
{
"description": "Folder name.",
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"page": {
"default": 1,
"description": "Page number, starting at 1.",
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Number of results per page.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "search_groups",
"description": "Search groups by name or email address (case-insensitive).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"query": {
"type": "string"
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "send_email",
"description": "Send an email.\n\nRecipients must be valid contacts in your address book.\nIf sending to a group you're a member of, you'll receive a copy.\n\nArgs:\n to: Recipient(s), comma-separated\n subject: Email subject\n body: Plain text email body\n html_body: HTML body (optional)\n cc: CC recipients, comma-separated (optional)\n bcc: BCC recipients, comma-separated (optional)\n attachments: Paths to files to attach (optional)\n\nReturns:\n JSON with sent status and email summary.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"to": {
"type": "string"
},
"subject": {
"type": "string"
},
"body": {
"type": "string"
},
"html_body": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"cc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"bcc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"attachments": {
"anyOf": [
{
"description": "Paths to files to attach.",
"items": {
"description": "Path to a file to attach.",
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"to",
"subject",
"body"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
},
{
"name": "update_draft",
"description": "Update an existing draft.\n\nOnly provided fields are updated; others remain unchanged.\n\nArgs:\n draft_id: ID of the draft to update\n subject: New subject (optional)\n body: New body (optional)\n html_body: New HTML body (optional)\n to: New recipient(s), comma-separated (optional)\n cc: New CC recipient(s), comma-separated (optional)\n bcc: New BCC recipient(s), comma-separated (optional)\n\nReturns:\n JSON with updated draft details.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"draft_id": {
"description": "Draft ID.",
"minLength": 1,
"type": "string"
},
"subject": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"body": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"html_body": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"cc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"bcc": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"mailbox_id": {
"default": "default",
"description": "Mailbox identifier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"draft_id"
],
"type": "object"
},
"outputSchema": {
"properties": {
"result": {
"type": "string"
}
},
"required": [
"result"
],
"type": "object",
"x-fastmcp-wrap-result": true
}
}
],
"toolsets": {
"read": [
"download_attachment",
"get_contacts",
"get_groups",
"get_drafts",
"get_emails",
"get_folders",
"get_mailbox_stats",
"get_scheduled_emails",
"get_unread_count",
"list_mailboxes",
"search_contacts",
"search_groups",
"search_emails"
],
"write": [
"add_contact",
"add_group",
"cancel_scheduled_email",
"create_folder",
"delete_contact",
"delete_group",
"delete_draft",
"delete_emails",
"delete_folder",
"edit_contact",
"edit_group",
"forward_email",
"mark_emails",
"move_emails",
"read_email",
"reply_email",
"save_draft",
"schedule_email",
"send_email",
"update_draft"
],
"core": [
"forward_email",
"get_emails",
"read_email",
"reply_email",
"search_emails",
"send_email",
"create_folder",
"delete_draft",
"delete_emails",
"delete_folder",
"download_attachment",
"get_contacts",
"get_drafts",
"get_folders",
"get_mailbox_stats",
"get_unread_count",
"mark_emails",
"move_emails",
"save_draft",
"update_draft"
],
"messages": [
"delete_emails",
"download_attachment",
"forward_email",
"get_emails",
"get_mailbox_stats",
"get_unread_count",
"list_mailboxes",
"mark_emails",
"move_emails",
"read_email",
"reply_email",
"search_emails",
"send_email"
],
"contacts": [
"add_contact",
"add_group",
"delete_contact",
"delete_group",
"edit_contact",
"edit_group",
"get_contacts",
"get_groups",
"search_contacts",
"search_groups"
],
"folders": [
"create_folder",
"delete_folder",
"get_folders",
"move_emails"
],
"drafts": [
"delete_draft",
"get_drafts",
"save_draft",
"update_draft"
],
"scheduling": [
"cancel_scheduled_email",
"get_scheduled_emails",
"schedule_email"
],
"toolathlon_legacy": [
"create_folder",
"delete_draft",
"delete_emails",
"delete_folder",
"download_attachment",
"forward_email",
"get_contacts",
"get_groups",
"get_drafts",
"get_emails",
"get_folders",
"get_mailbox_stats",
"get_unread_count",
"mark_emails",
"move_emails",
"read_email",
"reply_email",
"save_draft",
"search_emails",
"send_email",
"update_draft"
],
"state": [
"export_state",
"import_state"
]
}
}