Interactive views | API reference

`show_inbox`

Tool

Shows mail as an interactive list. Apps without MCP Apps get a text table.

Inputs

Name	Type	Required	Description
`inbox`	string	Optional	Inbox name (like "Work Gmail"), inbox id, or leave empty for all inboxes combined
`filter`	enum	Optional	needs (default: unread or VIP mail in the inbox, newsletters left out, unread automated mail older than attentionDays left out), vip, newsletters, today, since (since the last triage), all, reply: mail from a person addressed to you that you have not answered One of: needs, vip, newsletters, reply, today, since, all.
`since`	string	Optional	ISO time. Applies to whichever filter is set, not only "since": combine it with any filter for a single call ("newsletters from this week" is filter: newsletters, since: <start of this week>). For filter "since" alone, defaults to when the person last finished triage.
`offset`	number	Optional	Where to start. Pass nextOffset from the last page.
`limit`	number	Optional	Rows per page, 1 to 50. Default 25.
`timeZone`	string	Optional	The person's IANA time zone, like America/Chicago, so "today" means their calendar day. Without it, "today" is the last 24 hours.

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "show_inbox",
    "arguments": {
      "filter": "needs",
      "timeZone": "America/Chicago"
    }
  }
}

`triage`

Tool

The single pane: the inbox list with tabs for Newsletters and VIPs & rules. Pass pane to open on one.

Inputs

Name	Type	Required	Description
`inbox`	string	Optional	Inbox name (like "Work Gmail"), inbox id, or leave empty for all inboxes combined
`filter`	enum	Optional	needs (default: unread or VIP mail in the inbox, newsletters left out, unread automated mail older than attentionDays left out), vip, newsletters, today, since (since the last triage), all, reply: mail from a person addressed to you that you have not answered One of: needs, vip, newsletters, reply, today, since, all.
`since`	string	Optional	ISO time. Applies to whichever filter is set, not only "since": combine it with any filter for a single call ("newsletters from this week" is filter: newsletters, since: <start of this week>). For filter "since" alone, defaults to when the person last finished triage.
`offset`	number	Optional	Where to start. Pass nextOffset from the last page.
`limit`	number	Optional	Rows per page, 1 to 50. Default 25.
`timeZone`	string	Optional	The person's IANA time zone, like America/Chicago, so "today" means their calendar day. Without it, "today" is the last 24 hours.
`pane`	enum	Optional	Which tab to open on. Default mail. One of: mail, newsletters, rules.

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "triage",
    "arguments": {}
  }
}

`undo_view_action`

Tool

Undoes one earlier action from the inbox view. Works once, for 7 days.

Inputs

Name	Type	Required	Description
`undoId`	string	Optional	undoId from an earlier action.

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "undo_view_action",
    "arguments": {}
  }
}

`inbox_view_page`

App only

The inbox view switching tabs, filters, and pages. Agents call show_inbox.

Hidden from the model (visibility: ['app']). The interactive view calls it directly.

Inputs

Name	Type	Required	Description
`inbox`	string	Optional	Inbox name (like "Work Gmail"), inbox id, or leave empty for all inboxes combined
`filter`	enum	Optional	needs (default: unread or VIP mail in the inbox, newsletters left out, unread automated mail older than attentionDays left out), vip, newsletters, today, since (since the last triage), all, reply: mail from a person addressed to you that you have not answered One of: needs, vip, newsletters, reply, today, since, all.
`since`	string	Optional	ISO time. Applies to whichever filter is set, not only "since": combine it with any filter for a single call ("newsletters from this week" is filter: newsletters, since: <start of this week>). For filter "since" alone, defaults to when the person last finished triage.
`offset`	number	Optional	Where to start. Pass nextOffset from the last page.
`limit`	number	Optional	Rows per page, 1 to 50. Default 25.
`timeZone`	string	Optional	The person's IANA time zone, like America/Chicago, so "today" means their calendar day. Without it, "today" is the last 24 hours.
`inboxId`	string	Optional	Inbox id from list_inboxes.

`inbox_view_action`

App only

The inbox view running a click (archive, trash, spam, star, label). Agents use the triage tools.

Hidden from the model (visibility: ['app']). The interactive view calls it directly.

Inputs

Name	Type	Required	Description
`action`	enum	Required	What to do to the messages. One of: archive, trash, star, unstar, read, unread, label.
`items`	object[]	Required	Rows to act on, from show_inbox: inboxId and messageId.
`labelIds`	string[]	Optional	Gmail label ids from list_labels.
`vipConfirmed`	boolean	Optional

`attachment_link`

App only

The inbox view getting a short-lived download link when the person clicks Download on an attachment. Agents use get_attachment.

Hidden from the model (visibility: ['app']). The interactive view calls it directly.

Inputs

Name	Type	Required	Description
`inboxId`	string	Required	Inbox id from list_inboxes.
`messageId`	string	Required	Message id from list_messages, search_mailbox, or show_inbox.
`partId`	string	Required	Attachment partId from get_message.

`get_message_html`

App only

The inbox view loading one message as its sender designed it, cleaned so no scripts run, with remote images off until the person asks. Agents use get_message.

Hidden from the model (visibility: ['app']). The interactive view calls it directly.

Inputs

Name	Type	Required	Description
`inboxId`	string	Required	Inbox id from list_inboxes.
`messageId`	string	Required	Message id from list_messages, search_mailbox, or show_inbox.
`allowImages`	boolean	Optional