Ambiguous

One MCP server for an Ambiguous workspace: mail, docs, sheets, chat, calendar, CRM, tasks.

Opens Agent Studio, where connecting is one click. The connector URL below works in any MCP client.

Paste it into any MCP client. Setup docs

What the Ambiguous connector does

The Ambiguous MCP server gives Claude a whole Ambiguous workspace through one connection: mail, docs, sheets, slides, chat, calendar, drive, tasks, CRM, wiki, forms and e-signature. Our live listing returned 914 tools. Many act outward — sending email, posting chat messages, emailing quotes, inviting calendar attendees — and each runs with your workspace role.

Verified connector

Listed by Anthropic as a partner connector in its Connectors Directory.

Connection checked by Agentman on .

Anthropic states this reflects the level of review a connector received, not a security audit.

Ambiguous tools (914)

  • users_listRead-only

    List users in the active workspace. Powers @mention pickers, assignee dropdowns, etc. Filterable by q (matches display_name + username substrings or an owned workspace email address, case-insensitive). Limit defaults to 50, hard cap 100. Member-accessible — use this to resolve a name to a user_id when assigning tasks or @mentioning people; the admin list_users tool is admin-gated and 403s for members/coworkers.

  • auth_whoamiRead-only

    Return the current authenticated user's profile (works with both JWT and API-key auth), including active workspace name + ID and agent kind + manager when applicable. needs_workspace_setup: true indicates the account has no workspace yet.

  • auth_human_sessions_listRead-only

    List the caller's own active human client sessions across workspaces, current first then last server communication descending. A session is one authentication lineage, not an inferred physical device. Excludes agent credentials, API keys, app passwords, OAuth connections and memberships. Valid legacy sessions join the inventory when first observed; renewal writers need not be enabled.

  • auth_human_sessions_revokeDestructive

    Sign out one of the caller's own human sessions, including its renewed JWTs, workspace selections and renewal family. Unknown or foreign session ids return404; repeating an own-session revoke succeeds without another effect. Current-session revocation requires the client to use its ordinary local exit flow.

  • list_documentsRead-only

    List accessible documents, spreadsheets, presentations and canvases in the current workspace, returning IDs, titles, types and timestamps. Filter by type and paginate with limit/offset. scope=account includes documents owned in other workspaces; scope=workspace also includes documents shared here with the user's other account identities.

  • create_docActs

    Create a new doc. `content` is Markdown (recommended) or a ProseMirror JSON string. Returns the created document; read, update, share and trash it through the `/api/documents/{id}` operations. For a spreadsheet use `create_sheet`, for a deck `create_presentation`, for a whiteboard `create_canvas`.

  • get_docs_page_layout_defaultRead-only

    Get the caller's default layout for new Docs: `pageless_default: true` (the default) means new Docs start pageless, `false` means they start in pages.

  • set_docs_page_layout_defaultActs

    Set the caller's default layout for new Docs (`pageless_default: true` = pageless, `false` = pages). Affects only Docs created afterwards; existing Docs keep their layout.

  • documents_shared_with_meRead-only

    Documents shared with the calling account through an explicit permission grant, across every workspace and every identity the account owns. Excludes documents the account owns. Each row names the workspace that shared it and the role the grant carries. `scope=workspace` narrows discovery to resources in the authenticated current workspace without changing access.

  • documents_trash_listRead-only

    Find all deleted native Docs, Sheets, Slides and Canvas items owned by the caller. Returns their document IDs for documents_restore or documents_permanent_delete; optional type filters doc, sheet, slide or canvas. Uploaded Drive files and folders use list_trashed_files, which can also include materialized native-document shadow rows but is not a complete native-document trash list. An empty Drive-file trash result does not mean this document trash is empty.

  • documents_restoreActs

    Restore a trashed document.

  • documents_duplicateActs

    Make a copy. Title becomes 'Copy of <orig>'. Visibility resets to restricted; labels/pin/star are NOT inherited. Requires viewer access on the source.

  • export_documentRead-only

    Export a document, sheet, or slide to one of its supported standard formats. Sheets support xlsx, csv, tsv, and ods. Returns the file bytes with Content-Type and Content-Disposition attachment headers.

  • documents_export_job_createActs

    Start a PDF or DOCX export of a document, sheet, or slide without waiting for the render. Returns 202 with the job and status_url at once; the Location header points to the same path. Poll status_url until status is succeeded, then fetch download_url, or failed, whose error carries the status the synchronous export would have answered. The same idempotency_key returns the same job. Requires viewer access, and only the requester can read the job.

  • documents_export_job_getRead-only

    Read an export job started with documents_export_job_create. When status is succeeded, download_url is a short-lived signed URL for the file; read the job again for a new one. Only the requester, while still able to view the document, can read it; anyone else gets 404.

  • documents_export_job_contentRead-only

    The finished file of a succeeded export job, as an attachment, for the requester only. download_url names this path when the storage cannot sign a URL; otherwise use the signed URL.

  • get_documentRead-only

    Get a single document by ID, including its full content and comments. If the user is currently viewing a document, use the document ID from the page context.

  • update_documentActs

    Edit an existing document inline. Read the document first (get_document), modify the content, then pass the full updated text — content replaces the entire body. Do NOT create a new document to edit; version history preserves prior states. Accepts Markdown or ProseMirror JSON (HTML tolerated but lossy — drops listed in `import_warnings`). Provide only the fields you want to change.

  • migrate_document_sourceActs

    Activate source-preserving editing on an existing document. Only its owner may migrate; the expected content hash prevents stale activation and the command ID makes retries idempotent.

  • activate_document_logical_ownershipActs

    Prepare compatible readers and activate source-preserving paragraph structure editing on a generation-zero document. Requires edit permission, a current content hash and state vector, and a completed reader fence. Pending fence returns its ready-after deadline without activating the model.

  • list_document_suggestionsRead-only

    List pending suggestions and opaque complete-occurrence targets at the current content hash. Requires owner or editor access.

  • review_document_suggestionsDestructive

    Accept or reject selected opaque suggestion targets, or all pending suggestions, against the content hash returned by list_document_suggestions. Requires owner or editor access.

  • set_document_named_stylesActs

    Create, edit or remove typed paragraph and character style definitions with a guarded whole-registry command. Read current content first, preserve sparse native declarations and include the current content SHA-256. Explicit adoption authorizes replacing supported imported declarations; projection scope authorizes only derived style map/native carrier changes. Initial existing-document writes return a reader fence deadline; retry the same command after it drains. Concurrent stale changes refuse. The inverse registry is a new command guarded by the latest content hash. An optional restore_projections style-only preimage obeys the document body/walk limits and is accepted only when a forward replay reconstructs the current stored style projections.

  • documents_deleteDestructive

    Soft-delete a document (move to trash). Owner only.

Show the other 890 tools
  • documents_thumbnailRead-only

    Content-derived thumbnail for doc/sheet/slide cards. Returns SVG by default or PNG for Accept: image/png; cached privately for 60 seconds.

  • documents_asset_createActs

    Add an image to a doc/sheet/deck/board. Returns the parent-owned image URL `/api/assets/{id}/content`. Input: content_base64 bytes, source_file_id (copies a viewable Drive file), or source_url (copies public HTTPS through SSRF guard); no source link retained. Native sources without stored bytes return 422 native_document_not_copyable; attach it as a link. Byte-sniffed images only, 415 for other types or malformed SVG. SVG sanitized on upload and every read, inline image/svg+xml with restrictive CSP; malformed stored SVG returns 404. Drive SVG stays attachment. Owner quota exceeded 413; same image deduplicated per parent. Absent from Drive, readable exactly with parent.

  • documents_pinActs

    Toggle pinned state. Editor permission required (workspace-wide pin, not per-user).

  • get_document_headers_footersRead-only

    Get the default, first-page, and even-page headers and footers from a document as ProseMirror JSON nodes (or null if not set).

  • set_document_headers_footersActs

    Set default, first-page, and even-page headers and footers. Each field accepts a plain text string (auto-wrapped in a paragraph), a ProseMirror JSON node, or null to remove. Omit a field to leave unchanged.

  • get_document_footnotesRead-only

    Get the footnotes from a document. Returns an array of footnotes, each with a footnoteId, body content (PM JSON), and the positions of inline references (footnoteRef nodes) in the body text.

  • set_document_footnotesActs

    Set footnote body content on a document. Replaces the footnoteSection with canonical footnoteItem nodes. Each footnote must have a footnoteId and either text, inline PM JSON content, or one paragraph without paragraph formatting. Bodies that cannot be represented losslessly are refused. When stored model requirements apply, send model_features covering them; missing or incomplete required capabilities are refused with 409. To add inline footnote references in the body text, use update_document with PM JSON content containing footnoteRef nodes with matching footnoteIds.

  • get_document_page_styleRead-only

    Get the page-level formatting for a document: margins (in PT), page size (letter/A4/legal or custom {width, height} in PT), and orientation (portrait/landscape). Empty object means default formatting.

  • update_document_page_styleActs

    Set page-level formatting for a document: margins (PT), page size (letter/A4/legal or {width, height} in PT), orientation (portrait/landscape). 72 PT = 1 inch. These settings control export output (.docx, .pdf). Pass an empty object to reset to defaults.

  • claim_documentActs

    Make an unclaimed document yours. A document, spreadsheet, presentation or board created without an account returns a single-use `claim_key`; call this with it after signing in and the document moves into your active workspace with you as owner, keeping its id and URL. Its link drops to view-only, which you can raise again. A second claim of the same document, or a wrong key, is refused with 409 `claim_rejected`, which does not say which.

  • documents_versions_listRead-only

    List version snapshots, newest-first, cursor-paginated (default 50 per page). Walk via `next_cursor` until `has_more` is false.

  • documents_versions_createActs

    Create a manual snapshot (forces past the 5-minute throttle).

  • documents_version_getRead-only

    Get a version's metadata + serialized content snapshot.

  • rename_document_versionActs

    Rename a version snapshot of a document. Useful for labeling meaningful versions (e.g., "Pre-launch draft", "Board approved"). Requires editor permission.

  • delete_document_versionDestructive

    Delete a version snapshot of a document. At least one version must always remain — returns an error if attempting to delete the last version. Requires editor permission.

  • documents_version_revertActs

    Revert the document to a prior version. Force-snapshots current state first.

  • docs_create_named_rangeActs

    Create a named range (template placeholder) on a document. Named ranges anchor to ProseMirror node positions and are used for template-based document generation. Use replace_named_range_content to fill a named range with content. Name must be alphanumeric + underscore, must not start with a digit (e.g., party_name, companyAddress).

  • docs_list_named_rangesRead-only

    List all named ranges (template placeholders) defined on a document. Returns each range's name and its anchored node positions.

  • docs_delete_named_rangeDestructive

    Delete a named range (template placeholder) from a document by name. Names are unique per document.

  • replace_named_range_contentActs

    Replace all content within a named range with new content. Used for template-based document generation — define named ranges as placeholders, then call this to fill each one. The named range must have positional anchors (startNodeId/endNodeId). Content can be Markdown text or PM JSON. Returns 409 if the anchored nodes no longer exist (stale range after CRDT edits).

  • insert_page_breakActs

    Insert a page break into a document at a given position. Forces subsequent content to start on the next page in exported .docx and .pdf files. The page break is inserted as a block node between paragraphs.

  • insert_section_breakActs

    Insert a section break into a document at a given position. Section breaks divide the document into sections that can have different formatting. A 'next_page' section break forces content to the next page (like a page break but marks a new section). A 'continuous' section break starts a new section on the same page.

  • insert_page_numberActs

    Insert a page number placeholder into a document. The placeholder renders as the current page number in exported .docx and .pdf files. Commonly used inside headers or footers (e.g., 'Page X') but can also appear inline in the body text. The placeholder is inserted as an inline node within a paragraph.

  • set_pinned_header_rowsActs

    Set the number of pinned (repeating) header rows on a table in a document. Pinned header rows repeat on every printed page when the table spans multiple pages in exported .docx and .pdf files. Set to 0 to clear the pinned header rows attribute.

  • documents_tasks_adoptActs

    Move the caller's project-less tasks linked from this doc into `project_id`; set the doc's tasks project if unset. Other linked tasks are listed in `skipped` and unchanged.

  • list_channelsRead-only

    List the user's chat channels. Returns channels with id, name, type (public/private/dm), description, member count, and creator info. Use this when the user asks to see their channels, find a specific channel by name, or when you need a channel ID to send a message.

  • browse_public_channelsRead-only

    Browse the workspace's public channels, including the ones the caller has not joined, each with a `joined` flag and member count. `list_channels` returns memberships only, so this is the only way to discover a public channel you are not in and get the id `chat_channel_join` needs. Private channels and DMs are never listed. Use this when the user asks what channels exist, or asks to join a channel by name.

  • chat_channel_createActs

    Create a chat channel in the workspace.

  • mark_all_channels_readActs

    Mark all channels as read for the current user. Advances the read cursor in every channel the user is a member of to the latest message, clearing all unread badges at once. Use this when the user wants to dismiss all chat unreads (e.g. returning from vacation).

  • chat_channel_last_messagesRead-only

    Batch-fetch the latest message preview for multiple channels in one request. Pass `ids` as a comma-separated list of channel IDs (max 100). Returns one entry per channel the caller can read, each carrying its `channel_id`. Replaces per-channel `GET /messages?limit=1` calls so a DMs/channels list renders previews without an N+1 request fan-out.

  • chat_channel_engagementRead-only

    Rank the caller's channels and DMs by their own recent engagement: posts, reactions, and mentions of the caller over the last 30 days, each decaying with a 7-day half-life. Only channels the caller can view; score descending.

  • search_chat_messagesRead-only

    Find existing chat messages by keyword, phrase, or topic across the caller's accessible channels. Results include the message id and channel context needed to bookmark, remind, react, reply, or edit that message. Use channel_id to restrict the search to a known channel; this read does not post messages.

  • ack_thread_activityActs

    Acknowledge readable Threads inbox activity on entry without advancing personal read cursors or clearing explicit manual unread intent.

  • chat_thread_activity_listRead-only

    List thread-activity inbox for the current user. Powers the sidebar "Threads" inbox entry. Returns readable threads the user participates in or explicitly marked unread, with peer-only unread counts and own-inclusive unread anchors.

  • ack_mentions_activityActs

    Acknowledge the Mentions & reactions inbox after it has been displayed. Marks the caller's unread chat mention notifications read and stamps users.mentions_acked_at, so the projector recomputes both chat.mentions and chat.reactions to 0 durably (the sidebar "Mentions & reactions" item un-bolds and stays cleared across re-fetch). Per-channel read cursors are untouched, so channel message unread counts are unaffected; a reaction that arrives after the ack re-bolds the item.

  • list_saved_messagesRead-only

    List all messages the current user has saved (bookmarked) across all channels. Returns messages with saved_at timestamp, channel name, and channel type. Saved messages are private to the current user (unlike pinned messages, which are shared with the channel).

  • list_scheduled_messagesRead-only

    List all pending scheduled messages for the current user across all channels. Returns each scheduled message with channel name/type and the scheduled_at timestamp. Use this to review what's queued to send later, or before updating/cancelling a scheduled message.

  • update_scheduled_messageActs

    Edit the content or scheduled send time of a pending scheduled message before it's sent. Fails if the message has already been sent or cancelled. Use this when the user wants to fix a typo in a scheduled message or reschedule it.

  • cancel_scheduled_messageDestructive

    Cancel a pending scheduled message so it's never sent. Use this when the user says 'never mind' or changes their plan before the scheduled time.

  • send_scheduled_message_nowDestructive

    Deliver a pending scheduled message immediately instead of waiting for its scheduled time. Flips the message to sent and fans it out to the channel right now. Fails if the message has already been sent or cancelled. Use this when the user wants to send a queued message without waiting.

  • list_custom_emojisRead-only

    List all custom emojis uploaded to the current workspace. Returns each emoji with id, name (without colons), image URL, and creator info. Use this to discover what custom emojis are available before referring to them by name.

  • chat_emoji_imageRead-only

    Serve custom emoji image from GCS

  • delete_custom_emojiDestructive

    Delete a custom emoji from the workspace. Use this when the user asks to remove or clean up a custom emoji. This does not remove existing reactions or messages that used the emoji — it only stops new usage.

  • unfurl_linkRead-only

    Fetch OpenGraph / link-preview metadata for a URL (title, description, image, site name, favicon). Useful for generating rich previews of shared links, or inspecting what a URL would look like when shared in chat. Only http(s) URLs are allowed, and internal/private addresses are blocked.

  • get_user_statusRead-only

    Get the current user's active chat status (emoji + text) and DND-until timestamp. Use this before setting or clearing the status to know the current state.

  • set_user_statusActs

    Set the current user's chat status — an emoji, short text (<=100 chars), and optional auto-clear timestamp. All fields are optional; pass null to clear a single field. Use this when the user says things like 'set my status to lunch until 1pm' or 'I'm on vacation'.

  • clear_user_statusDestructive

    Clear the current user's status (emoji + text + expiresAt). Does NOT change DND — use set_user_dnd with until=null to clear DND separately.

  • set_user_dndActs

    Enable or disable Do-Not-Disturb for the current user. Pass an ISO-8601 timestamp in the future to snooze notifications until that time, or pass null to disable DND immediately. Use this when the user says 'mute me for an hour', 'DND until 5pm', or 'turn off DND'.

  • list_user_statusesRead-only

    List active chat statuses (emoji + text + DND) for users in the workspace. Only returns users who currently have a non-null status or active DND. Useful for 'who's on vacation?', 'is anyone in meetings?', or similar presence queries.

  • get_notification_keywordsRead-only

    Get the current user's notification keywords. The user receives a mention-style notification whenever any of these words appears in a message they can read.

  • set_notification_keywordsActs

    Replace the current user's notification keyword list. Keywords are case-insensitive, whole-word, and capped at 20 entries (each up to 50 characters). Duplicates/empties are dropped. Use this when the user says 'alert me whenever someone mentions X' or 'stop notifying me about Y'.

  • chat_channel_notification_preferenceActs

    Choose your channel notification level: all_messages, new_threads_mentions, mentions_only, or nothing (Off). A direct message (1:1 or group) has no level: it always behaves as all_messages, mute is its only control, and this write is refused 400 dm_notification_level_unsupported. New human memberships default to all_messages; agent and coworker memberships default to mentions_only. All messages includes every new message and thread reply. New threads + mentions includes new top-level messages, direct mentions, broadcasts, and followed-thread replies. Mentions only retains addressed messages and followed-thread replies. Off suppresses notifications and attention badges while retaining readable content and unread bolding. DND pauses all Chat notifications; temporary mute still admits addressed mentions. The legacy unread_only input maps to all_messages for humans and mentions_only for agents and coworkers. Per-member; other members are unchanged. Pass user_id to set an agent's level as an admin, owner or the agent's manager; nobody sets another human's level.

  • chat_channel_joinActs

    Self-join a public channel (no body required)

  • chat_channel_leaveDestructive

    Leave a chat channel you belong to.

  • mark_channel_readActs

    Mark a channel as read up to a specific message. This clears the unread badge for the current user. Use this after the user has finished catching up on a channel, or programmatically to dismiss unread counts after the assistant reports on recent messages.

  • mark_channel_unreadActs

    Mark a channel as unread starting from a specific message. Moves the calling user's read cursor back to just before that message, so the channel shows an unread badge and the message becomes the unread boundary. Use this when the user wants to revisit a conversation later.

  • get_channel_read_receiptsRead-only

    Get per-member read positions for a channel — who has read up to which message. Useful for reporting on whether an announcement has been seen by everyone.

  • list_pinned_messagesRead-only

    List all pinned messages in a channel. Pinned messages are highlighted by members for ongoing reference (announcements, canonical links, etc.). Returns messages in newest-pin-first order.

  • chat_saved_ids_listRead-only

    Get saved message IDs for a channel (for UI bookmarked state)

  • chat_channel_members_addActs

    Add member(s) or a group

  • chat_channel_member_removeDestructive

    Remove a member from a chat channel.

  • update_channel_member_roleDestructive

    Change a channel member's role to 'admin' or 'member'. Requires channel admin privileges. Use this when the user asks to promote or demote a member in a channel.

  • chat_channel_group_removeDestructive

    Remove a group from channel (clean up fan-out rows)

  • get_channel_messagesRead-only

    Get recent messages from a chat channel. Returns messages with id, content (Markdown), author info, reactions, thread reply count, and timestamps. Use this when the user asks to read messages, catch up on a channel, or find a specific conversation. If the user is currently viewing a channel, use the channel ID from the page context. Messages are returned in reverse chronological order (newest first).

  • send_messageDestructive

    Post a NEW message visible to the chat channel's members, or send a thread reply. Use for requested communication, not for finding, bookmarking, or reminding about an existing message: those actions use search_chat_messages/get_channel_messages then save_message/set_reminder on the returned message id. Content is Markdown with @mentions, code blocks, and links. Use the current channel ID when supplied by page context. To reply, set thread_id to the original parent message's id. To attach a file, upload it with drive_file_upload_proxy (source=chat) and include [name](drive://<file_id>) in content.

  • chat_message_updateDestructive

    Edit an Ambiguous-origin message or pin/unpin. Slack-origin content must be edited in Slack (409).

  • chat_message_deleteDestructive

    Delete one message from a chat channel. Slack-origin messages must be deleted in Slack (409).

  • bulk_delete_messagesDestructive

    Soft-delete up to 100 messages in a channel. Deletes only the IDs the caller may delete (own messages, or any message when the caller is a channel admin); every other ID returns in `rejected`. A batch affecting Slack-origin messages is refused with 409 before any deletion. Emits one bulk `message.deleted` event, never one per message.

  • get_message_readersRead-only

    List the users who have read a specific message (i.e. whose read-cursor is at or past this message). Use this to check whether a message (e.g. an important announcement) has been seen by specific people.

  • save_messageActs

    Bookmark an EXISTING chat message in the current user's private Later/saved list. Resolve the original message_id with search_chat_messages or get_channel_messages when it is not supplied. Does not post or copy a message, and does not set a timed reminder (use set_reminder for that). Saving an already-saved message is a no-op.

  • unsave_messageDestructive

    Remove a saved (bookmarked) message from the user's saved list. The message itself is untouched; only the personal bookmark is deleted.

  • set_reminderActs

    Remind only the signed-in user about an existing chat message at a future time. A channel named in a personal reminder request locates the source message; it is not an audience or a request to post there. When message_id is unknown, first find the original with search_chat_messages or get_channel_messages; an unknown ID does not mean the message is absent. If the target cannot be identified, ask for clarification instead of publishing a replacement. Automatically bookmarks the original in Later. remind_at is an ISO 8601 datetime and must be in the future.

  • clear_reminderDestructive

    Clear a pending reminder on a saved message. The message stays saved; only the reminder is removed.

  • snooze_reminderActs

    Re-snooze an existing saved message by updating its remind_at time. Resets reminded to false so the scheduler picks it up again. Accepts ISO 8601 datetime string; must be in the future.

  • chat_thread_getRead-only

    Get the replies in a chat message's thread.

  • mark_thread_readActs

    Mark a thread as fully read up to the latest reply. Use this after the user has finished catching up on a thread, or when you want to programmatically dismiss unread reply counts for a specific thread.

  • mark_thread_unreadActs

    Mark a thread as unread so it reappears in the threads inbox with an unread badge. An optional reply_id marks that reply onward unread. Omit it to mark the whole thread unread. Restore accepts the prior cursor and its expected current cursor; a newer intent returns 409.

  • chat_message_send_receiptRead-only

    Read identity-only evidence for your retained keyed message in the current workspace. Requires Chat read and current channel membership. Live and spent both confirm an accepted retained row; spent returns no deleted content. Neither certifies delivery. A missing, purged, foreign, or inaccessible result is the same generic 404/unknown, never proof that sending did not occur and never permission to resend or replace the key. This Read posts nothing and creates no membership.

  • chat_reactions_inboxRead-only

    Messages authored by the caller that carry reactions from other users. Powers the Mentions & Reactions inbox.

  • chat_mentions_inboxRead-only

    Messages from other users that @-mention the caller. Powers the Mentions tab.

  • chat_preferencesRead-only

    Workspace-level chat preferences readable by any authenticated member (default_reactions).

  • get_chat_link_previewsRead-only

    Get whether preview cards render under chat messages for the caller (`show_link_previews: true`, the default). The setting is the caller's own; it never changes what other people see or the sender's per-message preview size.

  • set_chat_link_previewsActs

    Show or hide preview cards under chat messages for the caller. `false` hides both workspace entity cards and external link cards; chips and links stay in the message, and nobody else is affected.

  • chat_channel_notification_prefsActs

    Update the caller's per-channel notification preferences (unread_display: count | dot | since_visit).

  • chat_channel_getRead-only

    Get a specific channel by UUID, with members.

  • chat_channel_updateActs

    Update a chat channel's name, topic or settings.

  • chat_channel_deleteDestructive

    Delete a chat channel and its messages.

  • poll_createActs

    Create a poll in a channel. Creator must be a channel member.

  • poll_get_by_messageRead-only

    Poll results for the poll attached to a chat message.

  • poll_getRead-only

    Poll details (question, options, the caller's votes).

  • poll_voteActs

    Cast a vote for a poll option.

  • poll_unvoteActs

    Remove the caller's vote for a poll option.

  • poll_resultsRead-only

    Tallied poll results (respects anonymity).

  • poll_closeActs

    Close a poll to further voting (creator or channel admin).

  • poll_deleteDestructive

    Delete a poll (creator or channel admin).

  • list_filesRead-only

    List files and folders in the user's Drive. Returns items with id, name, mime_type, size_bytes, is_folder, parent_folder_id, owner info, and timestamps. Use this when the user asks to see their files, browse a folder, find a specific file, or check what's in Drive. If the user is currently viewing Drive, use context for the current folder. A `parent_id` the caller cannot view answers 404, exactly as an absent folder does; a folder shared from another workspace is browsed through `GET /api/drive/{id}/children` instead.

  • list_folder_childrenRead-only

    List the direct children of one folder, named in the path. Use this to browse into a folder — including one shared with you from another workspace, which the `parent_id` form of the list endpoint cannot return. Answers 404 for a folder the caller cannot view, exactly as an absent one does.

  • list_drive_foldersRead-only

    List only folders (not files) in Drive — useful for folder pickers. Pass root to scope the listing to My Drive, shared drives, or Shared with me.

  • create_folderActs

    Create a new folder in Drive. Returns the created folder with id, name, and path. Use this when the user asks to create, make, or add a new folder for organizing files. Supports nested folders via parent_folder_id.

  • drive_folder_ancestorsRead-only

    Breadcrumb chain (root → leaf) for a folder. Powers breadcrumb hydration on deep-link reloads. Viewer permission is sufficient.

  • drive_file_requests_listRead-only

    List the caller's file requests for one owned Drive folder.

  • drive_file_request_revokeDestructive

    Revoke a folder's public file request immediately.

  • drive_file_upload_initActs

    Initiate a file upload. Use upload_url for direct GCS uploads. If GCS is unreachable, non-browser clients PUT raw bytes to api_upload_url on the Ambiguous API host within api_upload_max_bytes. Then confirm the returned file id. The API grant permits one admitted attempt; retry 429 after Retry-After. If a PUT result is uncertain, confirm the original file before initializing again. Browsers stay direct; do not mix the URLs.

  • drive_file_importActs

    Add a file to Drive from JSON, for clients that cannot send multipart: give either an https `url` to fetch (up to 100 MB) or the bytes as `content_base64` (up to 25 MB decoded), plus a `name`. The file goes through the same checks as a browser upload: its type is decided from the bytes, blocked types are refused, and it counts against the caller's storage quota. Links to private network addresses are refused, including through redirects. Returns the stored file.

  • drive_file_confirm_uploadActs

    Confirm a presigned upload completed successfully. Verifies the blob exists, rechecks its real size and stored bytes, then marks the file as confirmed and emits the upload event. A retryable storage-inspection failure leaves the upload pending and returns 503; a missing object removes the pending row and returns 410. Idempotent — confirming an already-confirmed file returns it unchanged without repeating the upload event.

  • get_drive_storageRead-only

    Get Drive storage usage.

  • get_drive_storage_breakdownRead-only

    Storage breakdown by file type.

  • drive_files_recentRead-only

    Recently used files for the current user — files they opened in the last 30 days (their own views, including files shared with them that they can still open) OR files they own created in the last 24 hours. Sorted newest first by their own last view, or creation for their own new files.

  • drive_files_suggestedRead-only

    Files the current user is likely to want next, each with the reason it is suggested: they opened it (`opened`), someone shared it with them (`shared`), or someone else added it to a folder they own or an agent they manage created it (`added`). Covers the last 14 days, newest reason first, at most one entry per file and only files the caller can still open. Stars never influence it. Use this for the My Drive home, not for a full history; use `drive_files_recent` for everything the user opened.

  • drive_files_starredRead-only

    Files the current user has starred.

  • drive_files_shared_with_meRead-only

    Files shared with the current user through a direct, team or external grant, newest share first (`sort=modified` orders by last modified instead). Each row carries `shared_at` and `shared_by`. Excludes files the user owns.

  • drive_tags_listRead-only

    Current user's tag catalog. Each tag carries name, color, and sort order.

  • drive_tag_createActs

    Create a new tag in the user's catalog.

  • drive_tag_updateActs

    Rename, recolor, or reorder a tag.

  • drive_tag_deleteDestructive

    Delete a tag (cascades to all file assignments).

  • drive_tag_files_listRead-only

    List everything you tagged with the given tag: Drive files, docs/sheets/slides and forms you own, newest first. Docs and forms carry `document_type`.

  • batch_get_filesRead-only

    Batch-fetch up to 50 files by ID. Powers drive:// embed hydration in Chat/Docs/Wiki/CRM.

  • batch_file_permissionsRead-only

    Batch-fetch permissions for up to 50 files by ID. Returns a map of file_id → permissions array.

  • bulk_move_filesActs

    Move multiple files to a folder (max 100). The destination needs editor access (contributor in a shared drive); a folder the caller cannot see answers 404 like one that does not exist, and a visible one they cannot write to answers 403. Per-file failures come back in `errors`: "File not found" for a file the caller cannot view, "Forbidden" for one they can view but not edit. An item whose sharing is restricted (editors can't share, on it or a folder above it) moves only with its owner.

  • bulk_copy_filesActs

    Copy multiple files to a folder (max 100). The destination needs editor access (contributor in a shared drive); a folder the caller cannot see answers 404 like one that does not exist, and a visible one they cannot write to answers 403. A copy into a shared-drive folder belongs to that drive.

  • list_trashed_filesRead-only

    Find deleted Drive file rows and folders the caller owns, trashed themselves, or holds the owner rung on (a folder above it is theirs, or they manage its shared drive). Returns paginated file IDs and metadata for restore_file or permanent_delete_file. Can include materialized native-document shadow rows, but does not list every native Docs, Sheets, Slides or Canvas item: use documents_trash_list for the complete native-document trash owned by the caller. An empty result does not mean the whole workspace trash is empty.

  • list_shared_drivesRead-only

    List shared drives user is a member of.

  • create_shared_driveActs

    Create a shared drive. Creator becomes a manager.

  • get_shared_driveRead-only

    Get shared drive details.

  • update_shared_driveActs

    Update a shared drive (manager-only).

  • delete_shared_driveDestructive

    Delete a shared drive (destructive, manager-only).

  • list_shared_drive_membersRead-only

    List shared drive members.

  • add_shared_drive_memberActs

    Add a member (manager-only).

  • update_shared_drive_memberDestructive

    Update a member role (manager-only).

  • remove_shared_drive_memberDestructive

    Remove a shared drive member (manager-only; cannot remove last manager).

  • list_shared_drive_filesRead-only

    List files in a shared drive.

  • drive_shared_drive_folder_createActs

    Create a folder inside a shared drive. Requires contributor+ on the drive. Pass `parent_folder_id` to nest.

  • drive_file_tag_attachActs

    Attach one of your tags to a Drive file, a doc/sheet/slide, or a form, so one tag can group a PDF with the document it belongs to. Owner-only (anyone else gets 404) and idempotent. Pass `resource_type` to name the kind, or omit it to infer it from the id.

  • drive_file_tag_detachDestructive

    Detach a tag from a Drive file, a doc/sheet/slide, or a form. Owner-only. Pass `?resource_type=` to name the kind, or omit it to infer it from the id.

  • drive_file_contentRead-only

    A file's bytes. A native item without stored bytes returns 422 native_document_not_copyable; attach it as a link. A browser is redirected to a short-lived signed storage URL where signing is available and is otherwise sent the bytes; an MCP tool call always gets the bytes, refused 413 above the MCP result size limit. Pass `?download=true` for `Content-Disposition: attachment`; default is inline. Content retrieval failures can return 503/504 via raw Response because those statuses are outside the typed contract error-code enum.

  • drive_revoke_galleryDestructive

    Revoke a folder gallery: restore the folder and its direct-child files to restricted and clear link settings. Owner-only. Legal-record children are left untouched.

  • restore_fileActs

    Restore a file from trash. Needs the owner rung (the owner, the owner of a folder above it, or a manager of its shared drive); a caller who can see the file without it gets 403. An item whose permanent deletion has started, or a folder holding one, cannot be restored: 409 FILE_PURGE_IN_PROGRESS.

  • export_drive_fileRead-only

    Export a workspace document (Doc, Sheet, or Slide) to a file format via its Drive ID. Docs support: docx, pdf, html, md. Sheets support: xlsx, csv. Slides support: pptx, pdf, html. Binary Drive files (images, archives, etc.) cannot be exported — use download instead.

  • get_file_infoRead-only

    Get detailed information about a file or folder in Drive. Returns id, name, mime_type, size_bytes, storage_key, owner info, parent folder, and timestamps. Use this when the user asks about a specific file's details, size, type, or location. If the user is currently viewing a file in Drive, use the resource ID from page context.

  • drive_file_updateActs

    Rename, move, or star/unstar a file. Rename and move require edit access; stars are owner-only. A move also needs editor access on the destination folder (contributor in a shared drive), and an item whose sharing is restricted moves only with its owner (403 `drive_move_requires_owner`).

  • delete_fileDestructive

    Delete a file or folder from Drive. This is a destructive action — always confirm with the user before executing. Deleting a folder also deletes all files inside it. Use this when the user explicitly asks to delete, remove, or trash a file or folder.

  • mail_external_auth_urlRead-only

    Start connected-mailbox (Gmail) OAuth — returns the consent URL.

  • mail_external_connections_listRead-only

    List connected mailboxes.

  • mail_external_connection_deleteDestructive

    Disconnect a connected mailbox.

  • mail_external_connection_testRead-only

    Verify a connected mailbox by fetching its Gmail profile.

  • search_mailRead-only

    Full-text + operator search (Gmail-style: from:, to:, cc:, bcc:, subject:, has:attachment, is:read|unread|starred, in:inbox|sent|drafts|trash|archive, label:, after:YYYY-MM-DD, before:YYYY-MM-DD, size:N, larger:N, smaller:N, "phrase"). cc:/bcc: filter by recipient type. size:/larger:/smaller: filter by body byte size.

  • mail_smart_composeActs

    Suggest a short continuation of an email draft being written. Takes the text typed so far, optionally the subject and the earlier messages of the thread being replied to, and streams the suggested next words.

  • mail_export_emlRead-only

    Export a message as RFC 5322 EML, returning retained source octets when available.

  • mail_folder_countsRead-only

    Per-folder badge counts for sidebar Returns { inbox: unread_count, drafts, scheduled, snoozed } — Gmail-style.

  • mail_unread_summaryRead-only

    Unread mail summary for a cross-module unread view: the total unread count plus the top N (default 5, max 25) unread inbox rows with sender, subject, preview and timestamp, so a unified list can render without pulling the full inbox.

  • list_send_as_addressesRead-only

    List available send-as addresses for current user

  • set_default_send_asActs

    Set the user's default send-as address.

  • mail_aliases_listRead-only

    List all aliases for current user's mailbox

  • mail_alias_createActs

    Add a new alias on a verified workspace domain

  • mail_alias_set_defaultActs

    Set alias as default send-as identity

  • mail_alias_deleteDestructive

    Delete a send-from alias address by id.

  • list_mail_approvalsRead-only

    List email submissions awaiting a human decision. Returns the caller's own submissions plus the ones they may decide — as the submitting agent's current manager, or as a workspace admin/owner. A former manager sees nothing.

  • get_mail_approvalRead-only

    Read one submitted email exactly as it will send — From, Reply-To, the complete To/Cc/Bcc set, subject, body with signature applied, attachment manifest, threading and requested schedule. A caller without access gets 404, never 403.

  • get_mail_approval_attachment_urlRead-only

    Presigned URL for one frozen attachment, addressed by its position in the manifest. The bytes are the copy taken at submit time, so a later edit of the source Drive file does not change what the reviewer reads. The URL is minted only after the review access check.

  • decide_mail_approvalActs

    Approve and send, request changes, reject, or (as the sender) withdraw one submitted email. The decision names the revision it applies to: exactly one decision per revision succeeds, and a decision on a superseded revision conflicts rather than releasing content the caller has not read. Approving records the human and time against that revision; it authorizes nothing else — not the thread, not a reply, not a later email.

  • mail_shared_mailboxes_listRead-only

    List the shared mailboxes the caller holds, or every one in the workspace with `scope=managed` (admin only)

  • mail_shared_mailbox_createActs

    Create a shared mailbox and address it on a workspace domain (admin only)

  • mail_shared_mailbox_getRead-only

    Get one shared mailbox and its members

  • mail_shared_mailbox_updateActs

    Rename a shared mailbox's display name; its address is unchanged (admin only)

  • mail_shared_mailbox_deleteDestructive

    Retire a shared mailbox (admin only). Soft: stored mail is retained and the address stays reserved.

  • mail_shared_mailbox_restoreActs

    Restore a retired shared mailbox (admin only). Total — delete cascaded nothing.

  • mail_shared_mailbox_assigneesRead-only

    The people who can hold a thread in this shared mailbox — team grants flattened to their members.

  • mail_shared_mailbox_member_addActs

    Grant a user or a team access to a shared mailbox (admin only)

  • mail_shared_mailbox_member_removeDestructive

    Revoke a user's or team's access to a shared mailbox (admin only)

  • get_mail_signatureRead-only

    Get the effective email signature.

  • set_mail_signatureActs

    Set personal email signature. Pass null to clear.

  • send_emailDestructive

    Finalize an unchanged saved draft with saved_draft: {id, revision} from its authorized detail Read; this reuses that email and starts no second Undo window. A stale or consumed occurrence returns 409; reconcile the same email instead of creating another send. Otherwise, send email as the current user: Markdown becomes HTML; To/Cc/Bcc use email addresses. For workspace-only agents, any external To/Cc/Bcc queues the WHOLE email for a human decision; no recipient gets delivery. Response delivery_status:pending_approval with pending_approval.review_id. Report awaiting approval, never sent; do not resend. A native Drive document attached without stored bytes returns 422 native_document_not_copyable; attach it as a link. A suppressed recipient returns 400 recipient_suppressed; replaying an older suppressed send without a saved reason returns 400 delivery_suppressed. The workspace external-send cap returns 429 external_send_limit_exceeded.

  • list_inboxRead-only

    List the user's received emails (inbox). Returns emails with id, from, subject, preview, read status, and sent timestamp. Use this when the user asks to check their inbox, see recent emails, or find a specific email. Use detail='headers' for bandwidth-efficient scanning (omits body), or 'minimal' for id + labels only. Use label_ids to filter by specific labels (AND semantics — all listed labels must be present).

  • list_sent_mailRead-only

    List the emails sent from this mailbox.

  • list_starred_mailRead-only

    List the starred emails in this mailbox.

  • list_snoozed_mailRead-only

    List the snoozed emails in this mailbox.

  • list_archived_threadsRead-only

    List archived threads (one per thread)

  • list_muted_threadsRead-only

    List muted threads (inbox view for muted conversations)

  • mail_trash_listRead-only

    List trashed (soft-deleted) emails — the caller's own rows in folder='trash'. Restore one with `untrash_email`; nothing is purged automatically.

  • list_draftsRead-only

    List the unsent draft emails in this mailbox.

  • create_draft_emailActs

    Create a draft email without sending it. The draft is saved in the drafts folder for later review, editing, or sending. Use this when the user wants to compose an email for later, save a draft, or prepare a message without sending it immediately. A native Drive document attached without stored bytes returns 422 native_document_not_copyable; attach it as a link.

  • update_draft_emailActs

    Update an existing draft email. Only works on drafts (not sent messages). Use this to refine recipients, subject, or body of a draft across multiple iterations before sending. A native Drive document attached without stored bytes returns 422 native_document_not_copyable; attach it as a link.

  • send_draft_emailDestructive

    Use to send a saved draft. Normal delivery moves it from drafts to sent, triggers SES and creates recipient inbox copies. For a workspace-only agent, any external To/Cc/Bcc instead queues the WHOLE email for human decision; nobody receives it. Response delivery_status: pending_approval and pending_approval.review_id. Report awaiting approval, not sent; never resend. A native Drive document attached without stored bytes returns 422 native_document_not_copyable; attach it as a link. A suppressed recipient returns 400 recipient_suppressed. The workspace external-send cap returns 429 external_send_limit_exceeded.

  • list_scheduled_mailRead-only

    List scheduled (unsent) emails

  • reschedule_scheduled_emailActs

    Change a pending delivery time, or remove its schedule with scheduled_at:null and expected_scheduled_at to retain the message as a draft.

  • get_undo_send_settingRead-only

    Get undo-send duration preference.

  • set_undo_send_settingActs

    Set undo-send duration (seconds).

  • undo_send_emailActs

    Undo an in-flight send within the undo-send window.

  • get_read_receipts_defaultRead-only

    Get read-receipts default for new compose.

  • set_read_receipts_defaultActs

    Toggle the default for new compose windows

  • get_snooze_presetsRead-only

    Get the user's custom snooze quick-presets. Returns defaults when no custom presets are saved.

  • set_snooze_presetsActs

    Set the user's custom snooze quick-presets (up to 10). Pass an empty array to reset to defaults.

  • get_swipe_actionsRead-only

    Get the caller's own mail-row swipe actions. Returns the defaults (right archive, left trash) when nothing is saved.

  • set_swipe_actionsActs

    Set the caller's own mail-row swipe actions — one action per direction, chosen from archive, trash, read, star, snooze.

  • get_email_opensRead-only

    Fetch open events for an email (sender only) Returns the rollup (first/last seen, open count) plus up to the most recent 50 individual open events. 403 if the caller doesn't own the email's mailbox.

  • list_mail_by_labelRead-only

    List emails with a specific label

  • get_mail_rule_changesetRead-only

    Read your rule-management receipt, Undo deadline and reported conflicts.

  • undo_mail_rule_changesetDestructive

    Restore uncontested rule configuration once within the server Undo window. Preserve later edits and labels now used elsewhere; report conflicts. Messages are never changed.

  • get_mail_rule_applicationRead-only

    Read progress, the first page and count of field conflicts, and the server undo_until for your own rule application.

  • list_mail_rule_application_conflictsRead-only

    Page the message fields a restoration left alone because they changed after the rule applied.

  • cancel_mail_rule_applicationDestructive

    Stop an active application and restore its uncontested changes in the background; the rule remains enabled.

  • undo_mail_rule_applicationDestructive

    Stop application and restore uncontested prior fields exactly once; expired Undo is refused visibly.

  • retry_mail_rule_applicationDestructive

    Resume a failed transactional job from its durable progress; committed messages are never reapplied.

  • map_mail_search_to_ruleRead-only

    Map supported search terms to conditions and name every omitted restriction. Preview changes nothing.

  • preview_mail_rule_importRead-only

    Preview size-limited Gmail API filter JSON plus a label map or an Ambiguous backup. XML must be normalized by the browser; unsupported restrictions skip the whole filter.

  • preview_mail_rule_exportRead-only

    Return serialized file bytes as text plus every Gmail loss and omission; Backup preserves writable configuration, on/off and order.

  • export_mail_rulesRead-only

    Download mailFilters.xml or an exact Ambiguous JSON backup. Use preview_mail_rule_export first to inspect every Gmail loss and omission.

  • list_mail_rulesRead-only

    List mail rules / filters.

  • preview_mail_ruleRead-only

    Preview the caller's received Inbox/Archive messages with the delivery matcher. Counts and pages matches within the newest candidates, showing the five newest by default. more_may_match means older messages were not read; applying the rule still covers them.

  • apply_mail_ruleDestructive

    Opt in to a durable background application of this rule to every received Inbox/Archive message received at or before submission that matches it, with no cohort cap; mail received later is handled by the saved rule itself. The job starts as collecting, with total growing until collection ends, then applies; read progress with get_mail_rule_application. Forward is unavailable, Trash needs confirm_trash, and notification-only rules cannot apply. Retry the same request with the same idempotency_key. Explicit retire_unaccepted:true reconciles that exact original request: a matching existing job is returned unchanged; a different request returns 409. If no job exists, retirement durably spends the caller's personal-mailbox key as an empty cancelled job with no rule reference. Retirement does not read or authorize the requested rule, does not cancel admitted work, and excludes the retirement flag from request identity.

  • reorder_mail_rulesActs

    Reorder the mail rules to change which runs first.

  • get_mail_ruleRead-only

    Get one mail rule's conditions and actions by id.

  • delete_mail_ruleDestructive

    Delete one mail rule by id.

  • list_mail_templatesRead-only

    List the saved mail templates in this mailbox.

  • create_mail_templateActs

    Create a reusable mail template for composing.

  • get_mail_templateRead-only

    Get one saved mail template by id.

  • update_mail_templateActs

    Update a saved mail template's subject or body.

  • delete_mail_templateDestructive

    Delete one saved mail template by id.

  • use_mail_templateActs

    Record one use of a saved mail template by incrementing its usage count and updating its last-used timestamp. Returns the template; does not compose or send an email.

  • list_mail_labelsRead-only

    List every mail label in this mailbox.

  • mail_label_countsRead-only

    Per-label unread counts for sidebar badges. A separate endpoint so the sidebar can refresh counts on read/receive without re-fetching the label definitions themselves. Shape mirrors /folder-counts.

  • create_mail_labelActs

    Create a mail label for organizing threads.

  • reorder_mail_labelsActs

    Reorder the mail labels shown in the sidebar.

  • update_mail_labelActs

    Update a mail label's name, color or sidebar order.

  • delete_mail_labelDestructive

    Delete one mail label from this mailbox.

  • get_vacation_settingsRead-only

    Get vacation auto-reply settings.

  • set_vacation_settingsDestructive

    Update vacation auto-reply settings.

  • list_blocked_sendersRead-only

    List all blocked senders for current user's mailbox

  • block_senderActs

    Block a sender (address or domain).

  • mail_blocklist_clearDestructive

    Unblock by raw pattern (convenience for "Unblock sender" button)

  • unblock_senderActs

    Unblock by id or pattern.

  • mail_blocklist_removeDestructive

    Unblock a sender by their blocklist entry id.

  • mail_message_unsubscribeDestructive

    One-click unsubscribe. Triggers the List-Unsubscribe URL (RFC 8058) on the user's behalf. Falls back to telling the client to open a mailto: link if no HTTP URL is present.

  • list_forwarding_addressesRead-only

    List forwarding addresses + recent log.

  • remove_forwarding_addressDestructive

    Remove a forwarding address

  • get_mail_threadActs

    Get all emails in a thread and its muted flag. By default, marks the thread read and updates unread counts; pass mark_read=false for a passive read.

  • mail_thread_mute_statusRead-only

    Check if a thread is muted

  • archive_mail_threadActs

    Archive every inbox-folder message in a thread

  • trash_mail_threadDestructive

    Trash all messages in a thread atomically. Moves every message in the thread to the trash folder.

  • untrash_mail_threadActs

    Restore all trashed messages in a thread to inbox. Only affects messages currently in trash.

  • batch_archive_emailsActs

    Archive multiple emails in one atomic call. Moves all specified messages to the archive folder. Use this when the user wants to bulk-archive many emails (e.g., inbox-zero cleanup, archiving all messages from a sender).

  • batch_trash_emailsDestructive

    Trash multiple emails in one atomic call. Moves all specified messages to the trash folder. Use this when the user wants to bulk-trash many emails (e.g., spam cleanup, clearing a project mailbox).

  • batch_modify_emailsActs

    Batch modify multiple emails in one atomic call. Can star/unstar, mark read/unread, add/remove labels, and change folder — all at once for up to 500 messages. Use this when the user wants to bulk-update many emails (e.g., star all from a sender, mark a batch as read, apply labels to multiple messages).

  • mail_bulk_modifyActs

    Apply mark_read, mark_unread, star, unstar, archive, unarchive, trash, untrash, label_add or label_remove to up to 500 emails selected by IDs or search_query. Label actions take payload.label. threaded=true includes whole conversations.

  • get_email_calendar_inviteRead-only

    Get calendar invite embedded in an email.

  • rsvp_email_inviteDestructive

    RSVP to a calendar invite on an email.

  • list_email_attachmentsRead-only

    List attachments for an email

  • get_email_attachment_urlRead-only

    Get an authenticated attachment content URL. Access is checked again when the content is read.

  • untrash_emailActs

    Restore a trashed email to inbox

  • snooze_emailActs

    Snooze an email until a datetime.

  • cancel_scheduled_emailDestructive

    Cancel a scheduled email

  • get_emailActs

    Get a single email by ID, including full Markdown body, sender, recipients (to/cc/bcc), subject, and timestamps. Use this when the user wants to read an email, see its contents, or reply to a specific message. If the user is currently viewing an email, use the email ID from the page context. Use detail='headers' for envelope fields only (no body), or 'minimal' for id + labels only. By default, marks the email read and updates unread counts; pass mark_read=false for a passive read.

  • mark_email_readActs

    Update email status (read/unread, starred, snoozed)

  • delete_emailDestructive

    Delete one email message by id.

  • task_asset_createActs

    Add an image to task description. Returns the parent-owned image URL `/api/assets/{id}/content`. Input: content_base64 bytes, source_file_id (copies a viewable Drive file), or source_url (copies public HTTPS through SSRF guard); no source link retained. Native sources without stored bytes return 422 native_document_not_copyable; attach it as a link. Byte-sniffed images only, 415 for other types or malformed SVG. SVG sanitized on upload and every read, inline image/svg+xml with restrictive CSP; malformed stored SVG returns 404. Drive SVG stays attachment. Owner quota exceeded 413; same image deduplicated per parent. Absent from Drive, readable exactly with parent.

  • list_task_templatesRead-only

    List task templates in the workspace. Templates pre-fill fields when creating tasks. Optionally filter by project. Returns name, default fields (priority, status, estimate, assignee, labels), and creator.

  • apply_task_templateActs

    Create a new task by applying a template's defaults. The template pre-fills status, priority, estimate, assignee, description, and labels. Override any field by passing it explicitly. Title is always required.

  • tasks_templates_getRead-only

    Get a single task template by ID.

  • tasks_templates_updateActs

    Update a task template. Workspace admins or project admins only.

  • tasks_templates_deleteDestructive

    Delete a task template. Workspace admins or project admins only.

  • tasks_exportRead-only

    Export authorized tasks matching the selected filters as CSV (default) or JSON. CSV includes human-readable columns and a task_json column containing the complete public task representation. Owned description images are embedded; an unavailable or malformed owned image refuses the export with its task reference.

  • tasks_batchRead-only

    Batch-fetch up to 50 tasks by ID. Powers LinkedTaskItem hydration in Docs/Wiki.

  • tasks_labels_listRead-only

    List task labels visible in the workspace, grouped by `group_name`. Without `project_id`, returns workspace-level labels only. With `project_id`, returns workspace-level labels plus labels scoped to that project.

  • tasks_labels_createActs

    Create a workspace task label. Returns 409 if a label with the same name already exists in the group.

  • tasks_labels_updateActs

    Update a task label.

  • tasks_labels_deleteDestructive

    Delete a task label. Existing assignments are removed.

  • tasks_sla_thresholdsRead-only

    Get the workspace's SLA thresholds (response + resolution times per priority). Auth-only.

  • tasks_sla_dashboardRead-only

    Aggregate SLA metrics for the workspace (compliance rates, avg times, counts per status). Optionally scope to a project.

  • tasks_views_listRead-only

    List task views accessible to the caller (own + shared + system defaults).

  • tasks_views_createActs

    Create a saved task view (filter + layout). Setting `is_shared: true` exposes it to the workspace.

  • tasks_views_updateActs

    Update a saved task view (rename, change filters or layout defaults, toggle sharing).

  • tasks_views_deleteDestructive

    Delete a saved task view.

  • tasks_views_layout_getRead-only

    Get the caller's layout preferences for a view, or fall back to the view's defaults. `source` indicates which.

  • tasks_views_layout_updateActs

    Upsert the caller's layout preferences for a view (per-project scope optional).

  • tasks_subscribedRead-only

    List task IDs the caller is subscribed to (manual + auto-subscribed via creator/assignee/comment).

  • bulk_update_tasksActs

    Bulk-update up to 100 tasks. Tasks you can't edit are skipped; `updated` counts the rest. Omitted fields stay unchanged; pass `null` to clear nullable fields.

  • bulk_delete_tasksDestructive

    Soft-delete multiple tasks at once by ID. Only deletes tasks the current user created. Max 100 task IDs per call. Subtasks cascade. Use `restore_task` to recover individually.

  • bulk_archive_tasksActs

    Archive up to 100 tasks at once. Only archives tasks the caller created or is assigned to.

  • tasks_inbox_countRead-only

    Count of triage-bucket tasks (untriaged + projects in 'triage' status). Powers the sidebar inbox badge.

  • tasks_favorites_listRead-only

    List your Tasks-sidebar pins: saved views and projects, not starred documents, Drive items, channels or teams.

  • tasks_favorites_addActs

    Pin a saved task view or project in your Tasks sidebar. For document, Drive, channel or team favorites, use set_resource_starred.

  • tasks_favorites_removeDestructive

    Unpin a saved task view or project from your Tasks sidebar, matching resource_type and resource_id. For other resource favorites, use set_resource_starred.

  • tasks_favorites_reorderActs

    Reorder your Tasks-sidebar view/project pins using ordered_ids (favorite-row IDs, top-to-bottom), not resource IDs.

  • tasks_by_keyRead-only

    Resolve a workspace-scoped task key (e.g. `TASK-123`) to its task ID. Used by deep links and integrations.

  • tasks_relations_batchRead-only

    Batch-fetch every relation type for up to 100 tasks. Powers relation overlays and sweeps.

  • list_tasksRead-only

    List tasks in the workspace. Pass assignee_id to filter by assignee (use the caller's user ID for 'my tasks'). Supports filtering by status, priority, project, and free-text query. Defaults retain full content and aggregates. Use fields= for sparse rows and include_counts=false on cursor continuation pages to avoid repeated aggregate work.

  • create_taskActs

    Create a new task. Auto-subscribes the creator and (if assigned) the assignee. Auto-sets SLA due date when priority is set without an explicit due_date. Auto-logs a CRM activity if linked to a contact.

  • tasks_labels_assignActs

    Assign a label to a task. Returns the task's full label list.

  • tasks_labels_removeDestructive

    Remove a label assignment from a task. Returns the task's remaining label list.

  • tasks_subscriptions_listRead-only

    List all users subscribed to a task (with the reason each is subscribed).

  • tasks_remove_subscriberDestructive

    Remove another user's subscription from a task. Requires task access.

  • tasks_subscription_statusRead-only

    Check whether the current user is subscribed to a task (and the reason if so).

  • task_collaborators_listRead-only

    List the collaborators on a task — the people holding `editor` on it (and its subtasks) without a role on its project.

  • task_collaborators_addActs

    Share a task with one workspace member: grants `editor` on this task and its subtasks (never on its project) and subscribes them. A projectless task is shared by its creator or assignee; a project task by an editor on that project.

  • task_collaborators_removeDestructive

    Revoke a task collaborator's grant. The add-time subscription is left in place — it grants no access on its own.

  • tasks_pr_linksRead-only

    List the pull requests linked to a task that you can see: a link shows only when you can read both the task and the repository.

  • tasks_subtasksRead-only

    List immediate subtasks of a task (`parent_task_id = :id`).

  • create_subtaskActs

    Create a subtask under the given parent task. Equivalent to `POST /api/tasks` with `parent_task_id` pre-filled from the URL parameter.

  • start_task_timerActs

    Start a time-tracking timer on a task for the current user. If another timer is already running for this user, it is stopped automatically (only one active timer per user).

  • stop_task_timerActs

    Stop the current user's active timer on this task and return the stopped entry. Adds its duration to time_spent_minutes. Returns 404 if this user has no active timer on the task.

  • tasks_activityRead-only

    List audit-log activity entries for a task (status changes, assignments, comments, label edits, etc.). Paginated via `limit`/`offset`.

  • tasks_relations_listRead-only

    List edges in the task-relations graph for a task (related, blocking, blocked_by, duplicate).

  • tasks_relations_createActs

    Create a relation between two tasks. `blocking`/`blocked_by` auto-creates the inverse edge. With `type=duplicate, mark_as_duplicate=true` the source task is cancelled with a system comment.

  • tasks_relations_deleteDestructive

    Delete a task relation edge. Auto-deletes the inverse edge for blocking/blocked_by pairs.

  • restore_taskActs

    Restore a soft-deleted task when the caller has task editor access.

  • duplicate_taskActs

    Clone a task — copies title (appends ' (copy)'), description, priority, project, goal, cycle, estimate, due/start date, recurrence, custom fields, and labels. The clone starts at status 'todo' with a fresh task key.

  • list_task_attachmentsRead-only

    List task-owned attachments and existing legacy attachments.

  • add_task_attachmentActs

    Copy a Drive file you can view into a task-owned attachment. The original remains independent. Re-attaching the same source returns the active attachment; a stable idempotency_key prevents replay after removal. A native doc, sheet, deck, canvas or form without stored bytes returns 422 native_document_not_copyable; attach it as a link.

  • remove_task_attachmentDestructive

    Remove a task attachment and its owned bytes. Removing a legacy attachment leaves its original Drive file unchanged.

  • get_taskRead-only

    Get a single task by ID, including full details: title, description, status, priority, assignee, due date, labels, and subtask count.

  • get_task_permissionsRead-only

    Read the caller's task editing, project-move and sharing permissions, with editable IDs for the first 200 immediate subtasks.

  • update_taskActs

    Update a task. Status changes to 'done' auto-spawn the next recurrence (when set), trigger CRM activity logging, and emit task.completed events.

  • tasks_deleteDestructive

    Soft-delete a task. Only the creator can delete.

  • project_templates_listRead-only

    List project templates in the workspace.

  • project_templates_createActs

    Create a project template.

  • project_templates_applyActs

    Create a new project from a template. Pass `{name, description}` in the body.

  • project_templates_getRead-only

    Get a single project template.

  • project_templates_deleteDestructive

    Delete a project template.

  • list_projectsRead-only

    List accessible projects in the current workspace, optionally filtering by a case-insensitive name query before pagination. Returns each project with name, icon, color, visibility, and task count. Use this when the user asks to see their projects or find a project by name.

  • create_projectActs

    Create a new project to group related tasks. A bound document or Wiki page atomically selects the new project; named source editor access is required. An already-bound source or a bound project with workspace visibility is refused.

  • get_projectRead-only

    Get a single project by ID, including task count, visibility, and metadata.

  • update_projectDestructive

    Update a project's name, description, icon, or color. Provide only the fields you want to change.

  • delete_projectDestructive

    Delete a project by ID. Only project admins or workspace admins can delete. Tasks belonging to the project are not deleted — they become unassigned from the project.

  • project_members_listRead-only

    List project members.

  • project_members_addActs

    Add a member. Body `{user_id, role?}` — or `{team_id, role?}` for a team share. A project editor may add, capped at its own role: granting a role above it is refused `403`. Notifies the new member.

  • project_members_update_roleDestructive

    Change a member's role.

  • project_members_removeDestructive

    Remove a grant from the project. The path id is the principal id: a user by default, or a team with `?type=team`. Notifies the removed user (unless self-removal). The Everyone team's row is refused — workspace access is set through the project's visibility, which is its only control.

  • list_project_updatesRead-only

    List status updates for a project, newest first. Returns the health timeline with author and timestamp.

  • create_project_updateActs

    Post a status update on a project. Use this when the user wants to report progress, flag a risk, or share a status update on a project. The status field captures the health signal (on_track, at_risk, off_track, paused, completed, cancelled).

  • project_updates_editActs

    Edit a status update. Author or admin only.

  • project_updates_deleteDestructive

    Delete a status update. Author or admin only.

  • project_notification_pref_getRead-only

    Get the caller's notification preference for the project.

  • project_notification_pref_setActs

    Set the caller's notification preference (`level`) for the project.

  • cycles_listRead-only

    List cycles in the active workspace. `?status=` filters by status; `?limit=` (1–200) and `?offset=` paginate. `has_more` is set when the underlying query returned a hint of more rows.

  • cycles_createActs

    Create a new cycle. Body fields: name, start_date, end_date, status?, cooldown_days?, auto_rollover?.

  • cycles_velocityRead-only

    Cross-cycle velocity (last N closed cycles). Default `limit=10`.

  • cycles_getRead-only

    Get one task cycle and its dates by id.

  • cycles_updateActs

    Update cycle fields.

  • cycles_deleteDestructive

    Delete a cycle. Tasks attached to the cycle are unlinked, not deleted.

  • cycles_analyticsRead-only

    Burndown + summary analytics for the cycle.

  • cycles_completeActs

    Complete a cycle. If `auto_rollover` is set, incomplete tasks are moved to the next cycle.

  • cycles_add_tasksActs

    Add tasks to the cycle. Body `{task_ids: [...]}`.

  • cycles_remove_tasksDestructive

    Remove tasks from the cycle. Body `{task_ids: [...]}`.

  • list_sheet_tablesRead-only

    List editable table definitions by worksheet.

  • write_sheet_tableActs

    Create or edit one table. Bounds describe DATA only; totals follow data. Current headers win; cell exceptions remain.

  • patch_sheet_tableActs

    Change supplied table fields only. Identity and unrelated declarations remain.

  • remove_sheet_tableDestructive

    Remove a table definition while retaining its cells.

  • list_table_stylesRead-only

    List workbook custom table styles.

  • write_table_styleDestructive

    Create or edit a named custom table style from differential elements. False and absent settings differ. expected_updated_at refuses stale replacements with 409; omission deliberately replaces.

  • remove_table_styleDestructive

    Delete an unused custom table style.

  • set_table_themeDestructive

    Set all twelve workbook theme colors; affects every theme-linked workbook feature. Null restores native/default palette. expected_updated_at refuses stale replacements with 409; omission deliberately replaces.

  • list_sparklinesRead-only

    List editable sparklines and their owning worksheet.

  • create_sparklineActs

    Create a native editable sparkline in one cell from a worksheet row or column.

  • update_sparklineActs

    Edit only the supplied sparkline fields while preserving unrelated workbook edits.

  • delete_sparklineDestructive

    Delete one editable sparkline without changing its source cells.

  • list_sheetsRead-only

    List the current user's spreadsheets (owned + shared). Convenience alias for `GET /api/documents?type=sheet`. Returns the lightweight `SheetSummary` shape without the structured `data` body — call `GET /api/sheets/:id` to load a specific sheet's tabs/columns/rows.

  • create_sheetActs

    Create a new spreadsheet. Returns the full `Sheet` envelope (id, title, owner, visibility, timestamps, and `data` body) so the caller can immediately read or edit cells without a second round-trip. Optional `content` may be a SheetData JSON object or a string that parses as JSON.

  • append_sheet_valuesDestructive

    Append rows of values to a sheet at the first empty row in a range. The server finds the insertion point — no need to read the last row first. Uses OVERWRITE semantics (does not shift existing data).

  • batch_get_sheet_valuesRead-only

    Fetch multiple disjoint ranges from a spreadsheet in a single request. Avoids N sequential round-trips when reading KPIs from different regions.

  • batch_clear_sheet_valuesDestructive

    Clear all cell values in multiple ranges atomically. Sets cells to null without removing rows or columns. Useful for resetting template sheets or clearing data regions.

  • copy_sheet_toActs

    Copy a sheet tab from one spreadsheet to another. Deep-copies columns, rows, formulas, formatting, and merges. Cross-document formulas will show as #REF!. Requires viewer access on source and editor access on destination.

  • create_named_rangeActs

    Create a named range or named expression on a spreadsheet. Send either an A1 range or an exact literal Excel expression, such as a structured table reference. External-workbook expressions are preserved verbatim and remain unresolved.

  • list_named_rangesRead-only

    List named ranges and named expressions on a spreadsheet. Each entry returns its name and either an A1 range or an exact literal expression. External-workbook expressions remain unresolved.

  • delete_named_rangeDestructive

    Delete a named range from a spreadsheet by name. Names are matched case-insensitively.

  • update_named_rangeActs

    Update a named range or named expression with either an A1 range or an exact literal Excel expression; optionally rename it with newName. Names are matched case-insensitively. External-workbook expressions are preserved verbatim and remain unresolved.

  • set_sheet_validationDestructive

    Set a data-validation rule on a spreadsheet cell range in A1 notation. Supports dropdown/range lists, numeric/text/date conditions, checkbox values, and custom formulas. Numeric constraints use JSON numbers, not numeric strings. Strict configures invalid-entry rejection rather than warnings in the editor; API cell writes do not enforce these rules.

  • clear_sheet_validationDestructive

    Remove a data validation rule from a spreadsheet by range. The range is matched after normalization (sheet tab defaults to Sheet1 if not specified). Returns 404 if no rule exists for that range.

  • list_sheet_validationsRead-only

    List all data validation rules on a spreadsheet. Returns each rule's range (A1 notation) and rule definition (type, values, strict, inputMessage).

  • list_conditional_formatsRead-only

    List all conditional formatting rules on a spreadsheet. Returns each rule's ID, ranges (A1 notation), and one canonical rule payload.

  • add_conditional_formatActs

    Add a conditional formatting rule to a spreadsheet. Provide one of booleanRule, gradientRule, iconSetRule, or dataBarRule. The server generates a unique ID for the rule.

  • update_conditional_formatDestructive

    Update a conditional formatting rule by ID. Partial update: ranges or one canonical rule payload; replacing the kind clears the previous kind.

  • delete_conditional_formatDestructive

    Delete a conditional formatting rule from a spreadsheet by its ID. Returns 200 on success, 404 if the rule does not exist.

  • list_protected_rangesRead-only

    List all protected ranges on a spreadsheet. Returns each range with its ID, A1 range, description, warningOnly flag, and editorUserIds allowlist.

  • protect_rangeActs

    Protect a range in a spreadsheet. Protected ranges restrict editing to users in editorUserIds. Set warningOnly to true for soft warnings instead of hard blocks.

  • unprotect_rangeDestructive

    Remove a protected range from a spreadsheet by its ID. Returns 200 on success, 404 if the range does not exist.

  • get_sheetRead-only

    Get a spreadsheet's structured data including columns, rows, and formulas. Returns the `Sheet` envelope: top-level metadata (id, title, owner, visibility, timestamps) plus the structured sheet body nested under `data` (see `SheetData`). Read the tab list as `response.data.sheets`; columns and rows are under `response.data.sheets[0]`, not at the response root. If the user is currently viewing a sheet, use the sheet ID from the page context.

  • sheet_get_dataRead-only

    Get the spreadsheet as the structured JSON canvas. Returns the `Sheet` envelope: top-level metadata plus the structured sheet body nested under `data` (see `SheetData`). Read the tab list as `response.data.sheets`; columns and rows are under `response.data.sheets[0]`, not at the response root.

  • get_sheet_rangeRead-only

    Use to read a rectangular slice, max 10,000 cells. Returns 2D values and resolved start/end letters+rows; orientation=COLUMNS yields column-major inner arrays. valueRenderOption: STORED(default) preserves raw values/formula strings; FORMULA forces formulas; EVALUATED runs server engine (SUM(A1:A3)→6). Cross-tab Sheet2!A1 resolves; cross-document IMPORTRANGE returns#REF!.

  • sheet_update_cellsActs

    Update specific cells in a spreadsheet. Provide an array of cell updates, each specifying the row index (0-based), column ID, and new value. Optional expected_content_sha256 checks the server-issued revision of the entire workbook; preconditions check stored cells and row_count_preconditions check exact tab row counts. All supplied checks run under the mutation lock. A mismatch, or a tab or column the sheet no longer has (TAB_NOT_FOUND, COLUMN_NOT_FOUND), returns 409 without changing values or formatting. If the user is currently viewing a sheet, use the sheet ID from the page context.

  • update_sheet_mergesDestructive

    Replace the complete merged-cell range collection for a sheet tab using zero-based inclusive startRow, startCol, endRow and endCol coordinates. Read the current sheet and retain unrelated entries when changing one merge. An empty merges array clears all merges on that tab.

  • add_sheet_tabActs

    Add a new tab to a sheet. Auto-generates the name if not provided.

  • rename_sheet_tabActs

    Rename an existing sheet tab.

  • remove_sheet_tabDestructive

    Remove a sheet tab by name. Cannot remove the last remaining tab.

  • replace_sheet_tabDestructive

    Replace a sheet tab's columns and/or rows wholesale. Use for bulk data replacement. Use update_cells for surgical edits.

  • update_sheet_validation_settingsActs

    Set worksheet validation prompt suppression without replacing cells, rules, or presentation. Send disablePrompts=null to restore the absent default setting.

  • set_sheet_column_typeActs

    Set a column's declared type without coercing cells. expected_type must match its current type under the document lock; null denotes absent type metadata. Conflicts return 409 without changing the workbook.

  • add_sheet_columnActs

    Add a column to a sheet tab.

  • remove_sheet_columnDestructive

    Remove a column from a sheet tab by column ID. Use `?sheet=` to target a tab other than the first.

  • delete_sheet_columnsDestructive

    Delete columns atomically and return the bounded change receipt for undo or redo.

  • add_sheet_rowsActs

    Append rows to a sheet tab. Each row is an object keyed by column ID. Example: [{"A": "Widget", "B": 9.99}]. The response carries `history`, a receipt for `restore-structure` undo and redo.

  • delete_sheet_rowsDestructive

    Delete rows from a sheet tab by 0-based index.

  • sort_sheetActs

    Sort a tab's rows by one column, optionally within an exact filter range. Re-anchors formulas, comment anchors, and cell notes so nothing orphans.

  • move_sheet_columnActs

    Move one or more consecutive columns to a new position. The response carries a history receipt for Undo. Rewrites dependent formulas so they follow the moved column to the same logical data, and re-anchors notes and comment anchors.

  • move_sheet_rowActs

    Move one or more consecutive rows to a new zero-based position, carrying its values, formatting, geometry and dependent references.

  • restore_sheet_structureActs

    Undo or redo a structural change receipt without overwriting unrelated later edits.

  • list_data_connectorsRead-only

    List data connectors registered on a sheet. Connectors fetch data from external sources (URL, CSV, etc.) into specific cells.

  • get_data_connectorRead-only

    Get a single data connector by ID, including its config and last-run status.

  • delete_data_connectorDestructive

    Delete a data connector. Does not affect the cells it previously wrote to.

  • list_data_connector_run_historyRead-only

    List recent execution history for a data connector. Each row records one manual or scheduled run with its status, duration, row count, and error (if any). Use the `limit` query param to cap the page size (default 20, max 100). Results are ordered by completion time, newest first.

  • list_pivot_tablesRead-only

    List every pivot table across every tab of the sheet. Each entry is annotated with the `tab` name it lives in.

  • create_pivot_tableActs

    Create a pivot table from sheet data. A new sheet tab is automatically created to hold the pivot. Specify the source data range, which columns to group by (rows/columns), and which columns to aggregate (values).

  • compute_pivot_tableRead-only

    Compute the result of a persisted pivot table — applies row/column grouping, value aggregation, sort orders, and any matching slicer filters, and returns the rendered cells. The pivot config itself (row/column/value fields, source range) is not modified.

  • update_pivot_tableActs

    Patch a pivot table's config, including native presentation and preferred cache identity. Only the fields you send are updated; the rest of the pivot config is preserved. Send `nativeCacheId: null` to clear its authored preference. Pass a `tab` field to move the pivot to a different tab.

  • delete_pivot_tableDestructive

    Remove a pivot table from the sheet. The host tab itself stays — only the pivot row in `pivotTables[]` is removed. Returns `{ deleted: true }` on success.

  • list_sheet_picture_groupsRead-only

    List editable picture groups with cell anchors and CSS pixel geometry. Every leaf references an image asset owned by this sheet; native group transforms use EMU coordinates.

  • create_sheet_picture_groupActs

    Create editable picture groups with cell anchors and CSS pixel geometry. Every leaf references an image asset owned by this sheet; native group transforms use EMU coordinates.

  • update_sheet_picture_groupActs

    Update editable picture groups with cell anchors and CSS pixel geometry. Every leaf references an image asset owned by this sheet; native group transforms use EMU coordinates.

  • delete_sheet_picture_groupDestructive

    Delete editable picture groups with cell anchors and CSS pixel geometry. Every leaf references an image asset owned by this sheet; native group transforms use EMU coordinates.

  • list_sheet_imagesRead-only

    List editable floating images with cell anchors and CSS pixel geometry. Image src must reference an image asset owned by this sheet.

  • create_sheet_imageActs

    Create editable floating images with cell anchors and CSS pixel geometry. Image src must reference an image asset owned by this sheet.

  • update_sheet_imageActs

    Update editable floating images with cell anchors and CSS pixel geometry. Image src must reference an image asset owned by this sheet.

  • delete_sheet_imageDestructive

    Delete editable floating images with cell anchors and CSS pixel geometry. Image src must reference an image asset owned by this sheet.

  • list_sheet_shapesRead-only

    List editable floating shapes with editable text, cell anchors and CSS pixel geometry.

  • create_sheet_shapeActs

    Create editable floating shapes with editable text, cell anchors and CSS pixel geometry.

  • update_sheet_shapeActs

    Update editable floating shapes with editable text, cell anchors and CSS pixel geometry.

  • delete_sheet_shapeDestructive

    Delete editable floating shapes with editable text, cell anchors and CSS pixel geometry.

  • list_chartsRead-only

    List every chart across every tab of the sheet. Each entry is annotated with the `tab` name it lives in.

  • create_chartActs

    Embed a chart on a tab of the sheet. Charts visualize a rectangular data range — pick a chart type (bar / line / pie / scatter), the source range, and an overlay position. Returns the created chart with its server-assigned id.

  • update_chartActs

    Patch a chart's config — type, title, data range, overlay position, or series styling. Only the fields you send are updated; the rest of the chart config is preserved.

  • delete_chartDestructive

    Remove a chart from the sheet. Returns `{ deleted: true }` on success.

  • list_slicersRead-only

    List every slicer across every tab of the sheet. Slicers are interactive filter widgets that filter pivots / charts on a shared source range. Each entry is annotated with the `tab` name it lives in.

  • create_slicerActs

    Add a slicer to a tab of the sheet. Slicers filter pivot tables and charts that share the same source range by the values selected for a single column. `selectedValues: null` passes everything through; `[]` filters everything out; a non-empty array passes only those values. Returns the created slicer with its server-assigned id.

  • update_slicerActs

    Patch a slicer's config — source range, target column, selected values, overlay position, or title. Only the fields you send are updated; the rest of the slicer config is preserved.

  • delete_slicerDestructive

    Remove a slicer from the sheet. Returns `{ deleted: true }` on success.

  • slide_layouts_listRead-only

    List the slide-level layouts the editor knows about.

  • slide_templates_listRead-only

    List the built-in slide deck templates.

  • slide_save_as_templateActs

    Save an existing deck as a reusable workspace template. Deep-copies the deck with fresh element IDs into a new workspace-visible template document; the source deck is left untouched. Returns the new template's ID.

  • slide_use_templateActs

    Start a new deck from a template — built-in or workspace. Deep-copies the template deck with fresh element IDs into a new deck, substitutes `{{key}}` placeholders to bracketed prompts (e.g. `{{client_name}}` → `[Client Name]`), and returns the new deck's ID.

  • slide_stars_listRead-only

    List IDs of slide decks the current user has starred.

  • create_presentationActs

    Create a new presentation deck. Omit `content` for a deck with one blank slide, or pass deck JSON to create it with its slides in place: `{ slides: [{ elements: [{ type: "text", x: 80, y: 60, w: 800, h: 80, text: "Q1 review", fontSize: 44 }] }] }`. A slide is 960 by 540 units with a top-left origin, and elements take the shape `add_slide` accepts. Returns the created `SlideDeck` envelope.

  • get_presentationRead-only

    Get a presentation's full data including all slides and their elements. Returns the `SlideDeck` envelope: top-level metadata (id, title, slide_count, owner, visibility, timestamps) plus the structured deck body nested under `data` (see `SlideDeckData`). Read settings/slides/masterSlides as `response.data.slides[…]`, not at the response root. If the user is currently viewing a presentation, use the presentation ID from the page context.

  • add_slideActs

    Use to add a JSON slide with layout/background/elements. Each typed text/image/shape/table/video/group has x, y, w, h and type fields. Give EACH title/bullet/paragraph its own positioned text element, never multiple lines/bullets together. Use • bullets, not Markdown * or -. Set fontSize/fontWeight hierarchy. If viewing a presentation, use its ID from page context.

  • update_slideDestructive

    Update an existing slide in a presentation. Specify the slide by its 0-based index. You can update the slide properties (background, notes) and/or replace its elements. If the user is currently viewing a presentation, use the presentation ID from the page context.

  • remove_slideDestructive

    Remove the slide at the given zero-based index.

  • apply_master_to_slideActs

    Link a master slide to a specific slide by 0-based index. The slide stores a by-reference link, retains its existing elements as child-owned content, and clears prior master-element override markers. Current master elements inherit at render time and future master edits flow through automatically.

  • group_slide_elementsActs

    Group existing top-level elements on a slide into a single group. The group's bounding box is computed automatically from the children. Children positions become relative to the group origin. At least 2 element IDs required. A named element may itself be a group — `groupElements` validates only that each id is top-level on the slide, so groups nest.

  • ungroup_slide_elementsActs

    Dissolve a group element on a slide back into independent top-level elements. Children positions are converted from group-relative to absolute coordinates. The group element is removed and its former children become top-level elements on the slide.

  • duplicate_slideActs

    Deep-copy a slide within the same deck. The duplicate is inserted immediately after the source slide. All elements (including group children) receive new unique IDs to avoid collisions. Useful for template-based workflows: duplicate a template slide, then update the copy with new content.

  • get_slide_thumbnailRead-only

    Get the PNG thumbnail bytes for a specific slide. Sizes: small (200px), medium (800px, default), large (1600px). A render with an exhausted transient image read has no ETag and Cache-Control:no-store; deterministic placeholders keep their validator. A busy renderer answers 503 slide_thumbnail_capacity_exceeded with Retry-After.

  • detach_master_from_slideActs

    Detach a slide from its master. The slide keeps its current rendered elements but no longer inherits from the master.

  • apply_transition_to_allActs

    Apply a slide transition to every slide in the deck. Set transition.type to 'none' to clear transitions on all slides. Prefer duration_s (float seconds, 0.1–10); legacy speed presets map to slow=1.0s, medium=0.5s, fast=0.3s.

  • reorder_slidesActs

    Reorder slides in a presentation. Provide the full list of slide indices in the desired new order. Example: [2, 0, 1, 3] moves the third slide to the front.

  • update_deck_settingsActs

    Update deck-level settings: theme, aspect ratio, default background. Changing aspect ratio rescales every slide's elements proportionally; changing default background updates slides currently using the old default.

  • list_slide_mastersRead-only

    List the master slide templates registered on a presentation. Child slides link to masters by reference and resolve current master elements at render time, beneath child-owned elements.

  • create_slide_masterActs

    Create a new master slide for a deck. If no elements are provided, a default Title + Subtitle layout is used.

  • update_slide_masterActs

    Update a master slide's name, background, or elements. Slides using the master resolve the updated elements by reference.

  • delete_slide_masterDestructive

    Delete an unused master slide. Returns 409 with the referencing slide count while the master is in use.

  • find_and_replace_in_deckDestructive

    Find and replace text across all slides in a presentation. Searches every text element and table cell on every slide. Useful for template-based workflows: create a deck from a template with placeholders like {{company_name}}, then replace them programmatically. Plain string matching only (no regex).

  • set_deck_fontsActs

    Set the heading and/or body font across a whole presentation: every text box, shape and table on every slide and master, group children and per-run rich-text fonts included. Text at 28px or larger takes the heading font; smaller text and tables take the body font. Fonts are a closed list. The saved deck is re-read before responding: a 409 means some elements still use another font, so the change is incomplete and must not be reported as done.

  • replace_shapes_with_imageDestructive

    Replace text placeholder elements with an image across all slides. Finds text elements whose text matches the search string and replaces them with image elements at the same position and size. Matching placeholder shapes such as {{logo}} are removed and replaced with images.

  • get_cover_thumbnailRead-only

    Get the PNG thumbnail bytes for the first slide (cover image) of a presentation. Convenience endpoint — equivalent to get_slide_thumbnail with index 0. A render with an exhausted transient image read has no ETag and Cache-Control:no-store; deterministic placeholders keep their validator. A busy renderer answers 503 slide_thumbnail_capacity_exceeded with Retry-After.

  • slide_apply_templateDestructive

    Apply a slide template — built-in or workspace — to the deck or to a single slide.

  • create_canvasActs

    Create a new empty canvas for an infinite whiteboard. Use when starting a fresh flowchart, product map, or swimlane flow; returns the canvas envelope with an empty `data.elements`, then add objects with create_canvas_element. Coordinates: board units, top-left origin, +x right / +y down. Example: create_canvas({ title: "Q1 product map" }) → { id: "<boardId>", data: { elements: [] } }.

  • get_canvasRead-only

    Get a full canvas by id, including every element in `data.elements`. Use when you need the complete board; for a large board prefer get_canvas_manifest (ids/types/bounds only) or get_canvas_frame to stay within context budget. Coordinates: board units, top-left origin, +x right / +y down. Example: get_canvas({ id: "<boardId>" }) → the board with all elements.

  • update_canvasActs

    Update canvas-level metadata (title, preview cover). Use to rename a canvas or set its preview; never touches elements — use the element ops for board content. Coordinates: board units, top-left origin, +x right / +y down. Example: update_canvas({ id: "<boardId>", title: "Renamed board" }).

  • update_canvas_timerActs

    Control a board's shared brainstorm countdown. Use to time-box a round: start (with duration_ms), pause (banks remaining time), resume (from banked time), or reset (clear). The server stamps `ends_at` from its own clock, so every participant renders the same countdown regardless of local clocks; the timer touches no elements. Coordinates: board units, top-left origin, +x right / +y down (unaffected by the timer). Example: update_canvas_timer({ id: "<boardId>", action: "start", duration_ms: 300000 }) starts a 5-minute countdown.

  • get_canvas_manifestRead-only

    Get a bounded manifest of a board — element ids, types, and bounds only (no style/content). Use this to survey a large board cheaply, then fetch a specific frame or the full board for detail. Coordinates: board units, top-left origin, +x right / +y down. Example: get_canvas_manifest({ id: "<boardId>" }) → { element_count, elements: [{ id, type, x, y, w, h }] }.

  • get_canvas_frameRead-only

    Get a frame (or swimlane) element and its children — every element whose `frameId` points at it. Use to read one region of a large board in full detail. Coordinates: board units, top-left origin, +x right / +y down. Example: get_canvas_frame({ id: "<boardId>", frameId: "<frameId>" }) → { frame, elements: [...] }.

  • get_canvas_elementsRead-only

    Use to refresh changed elements: ids is comma-separated, max500; returns only requested members. An absent requested id is deleted—drop it locally. Coordinates: board units, top-left origin, +x right/+y down. Example: get_canvas_elements({id:"<boardId>", ids:"el-a, el-b"}) returns only surviving elements. HTML embed markup appears as html only for one requested id; multi-id, whole-board and manifest reads omit markup. With canvas_embeds off, the single HTML read returns 404 module_unavailable; ordinary element reads omit html.

  • batch_canvas_elementsDestructive

    Use to create, patch or delete several elements in one call (building a board, laying out a diagram, moving or deleting a group) instead of repeated create_canvas_element, patch_canvas_element or delete_canvas_element calls. operations run in order: create {element: the create_canvas_element body}, patch {element_id, patch: the patch_canvas_element body}, delete {element_id}. Each succeeds or fails alone with the reason its single-element tool gives; failures leave the rest applied. A create's temp_id works later wherever an element id goes (element_id, frameId, connector from/to element); temp_ids maps it to the minted id. Too many operations: 400 canvas_batch_too_large names the limit; split. Coordinates: board units, top-left origin, +x right/+y down. Example: batch_canvas_elements({id:"<boardId>", operations:[{op:"create", temp_id:"a", element:{type:"sticky", x:0, y:0, w:160, h:120, content:"Idea"}}, {op:"create", temp_id:"b", element:{type:"shape", shape:"rect", x:240, y:0, w:160, h:120}}, {op:"create", element:{type:"connector", from:{element:"a", anchor:"e"}, to:{element:"b", anchor:"w"}, x:0, y:0, w:0, h:0}}]}).

  • create_canvas_elementActs

    Use to create a new sticky/text/shape/image/codeBlock/frame/swimlane/connector/metric/embed/portal. Several elements: one batch_canvas_elements call writes the board once; repeated single calls each wait on the board lock. Fields are flat, id is the board; server mints element id and preserves others. Coordinates: board units: top-left origin, +x right/+y down; x, y, w, h geometry. Type fields: sticky/text content; shape shape/content; image src; codeBlock code/language; frame name/metricWindow; metric report insights:<id>|funnels:<id>, optional step/title/window {from, to} (today-28d/now), live report values. Connector from/to: {element, anchor:n|s|e|w} follows shapes; {point:{x, y}} stays fixed; x, y, w, h=0. Example: create_canvas_element({id:"<boardId>", type:"sticky", x:100, y:80, w:160, h:120, content:"Idea"}). Embed: sandboxed frame, kind html/url, title, interactive=false (no scripts/forms); true allows interaction. html for kind html or src for kind url; https URL required (400 embed_url_invalid). Never send src for html. HTML: inlined single file, 5 MB UTF-8 max (413 embed_html_too_large), stored board asset/src. Responses/board reads: src, never markup; only get_canvas_elements with one id returns html. No markup messages; comments reach you by mention or reading the board, never wake you unmentioned. Embed example: create_canvas_element({id:"<boardId>", type:"embed", kind:"html", title:"Mockup", interactive:false, x:0, y:0, w:640, h:480, html:"<!doctype html><button>Pay</button>"}). canvas_embeds off: create, html/src/interactive patches, URL mint, serve, both asset markup reads 404 module_unavailable; single read omits html; move/resize/rename/lock/delete work. Portal: live targetId as viewer; modules/selectors/default sizes docs {}/480x640, slides {slide} zero-based first default/480x270, sheets {range} A1 import-range cap/560x320, canvas {frameId}/560x400. Wrong-module/malformed/over-cap 400 portal_selector_invalid; inaccessible target module 404; title server-written create/patch, never send. Host board/portal-containing frame 400 portal_recursive; connection 400 portal_not_connectable, use create. Geometry required. Example: create_canvas_element({id:"<boardId>", type:"portal", module:"sheets", targetId:"<id>", selector:{range:"Sheet1!A1:D10"}, x:0, y:0, w:560, h:320}). canvas_portals off: create/selector patch 404 module_unavailable.

  • add_connected_elementActs

    Use to extend a flowchart/map/swimlane: source_element_id and direction n/s/e/w place a new node one standard gap away, clear overlaps, and create its attached connector. Optional drop_point {x, y} centers the node there instead. element sets its type; omit to duplicate source. Connector/frame/swimlane types refused; portal source returns 400 portal_not_connectable. Coordinates: board units, top-left origin, +x right/+y down. Example: add_connected_element({id:"<boardId>", source_element_id:"<elId>", direction:"e", element:{type:"shape", shape:"diamond"}}) returns element and connector.

  • patch_canvas_elementActs

    Use to patch one element to move/restyle/relabel/reanchor: only changed fields; id/type fixed, others preserved. Several elements: one batch_canvas_elements call writes the board once; repeated single calls each wait on the board lock. Style replaces; style:null removes. Coordinates: board units: top-left origin, +x right/+y down; x, y move top-left. Example: patch_canvas_element({id:"<boardId>", elId:"<elId>", x:240, y:80}). Embed: sandboxed frame; interactive=false runs no scripts/forms; kind fixed; title/interactive editable. HTML single inlined UTF-8 file, 5 MB max (413 embed_html_too_large); new board asset/src, old markup in version history. src only URL kind, https required (400 embed_url_invalid otherwise; HTML src returns 400 embed_src_managed). Responses src, never markup; only get_canvas_elements with one id returns html. Embed example: patch_canvas_element({id:"<boardId>", elId:"<elId>", html:"<!doctype html><button>Pay</button>"}). canvas_embeds off: create, html/src/interactive patch, URL mint, serve, both asset markup reads 404 module_unavailable; single read omits html; move/resize/rename/lock/delete work. Portal module/targetId fixed; patch selector: docs {}, slides {slide} zero-based first default, sheets {range} A1 import-range cap, canvas {frameId}. Wrong-module/malformed/over-cap 400 portal_selector_invalid. Viewer access, target module 404; title server-written create/patch, never send. Host/portal-containing frame 400 portal_recursive; connection 400 portal_not_connectable. Resize docs480x640, slides480x270, sheets560x320, canvas560x400. Example: patch_canvas_element({id:"<boardId>", elId:"<elId>", selector:{range:"Sheet1!A1:F20"}, w:560, h:320}). canvas_portals off:selector patch 404 module_unavailable; move/resize/lock/delete work.

  • delete_canvas_elementDestructive

    Delete one element from a board by id. Use when removing an object; connectors attached to it are not auto-deleted, so patch or delete those separately. A locked element answers 409 element_locked; unlock it first. Several elements: one batch_canvas_elements call writes the board once; repeated single calls each wait on the board lock. Every other element is untouched. Coordinates: board units, top-left origin, +x right / +y down (unchanged by a delete). Example: delete_canvas_element({ id: "<boardId>", elId: "<elId>" }).

  • list_crm_lifecycle_stagesRead-only

    Read the workspace People lifecycle registry, including archived stages. An unconfigured workspace uses the seven default stages.

  • create_crm_lifecycle_stageActs

    Add a People lifecycle stage with an immutable key. Workspace admins only. Keys cannot be deleted or reused; archive a stage to hide it from assignment controls.

  • update_crm_lifecycle_stageActs

    Rename, reorder, archive or restore a People lifecycle stage without changing its stable key or contacts. Workspace admins only.

  • list_crm_workspace_usersRead-only

    List all users (humans and agents) in the current workspace who can own CRM records. Use before assigning contacts or deals to a specific owner_id.

  • list_address_bookRead-only

    List the caller's address book: the shared CRM contacts they can see unioned with their own privately captured addresses, deduplicated on email with the shared record winning. Use this to resolve a recipient the user has written to before instead of asking them to retype an address. Private entries are never visible to another member.

  • list_crm_property_definitionsRead-only

    List the workspace's typed custom-property definitions for contacts and deals, including relation properties that link a record to another contact, company, or deal. Optionally filter by entity_type.

  • create_crm_property_definitionActs

    Define a typed custom property for contacts or deals. field_type 'relation' (with relation_target contact|company|deal) makes the property a link to another record: values written to custom_properties under this key must be the id of an existing record of the target type.

  • update_crm_property_definitionActs

    Update a custom-property definition's label or select options.

  • delete_crm_property_definitionDestructive

    Delete a custom-property definition. Existing custom_properties values are left in place; they simply stop being typed.

  • get_crm_metricsRead-only

    Get pipeline metrics summary: total open deals, total deal value, win rate, deals won/lost, and recent activity counts. Useful for high-level pipeline health questions.

  • get_crm_reportsRead-only

    Get CRM revenue, deals-by-source, pipeline-by-owner, and activity reports for accessible records, optionally scoped to one pipeline. Each report preserves its own timestamp axis.

  • list_contactsRead-only

    List CRM contacts. Supports filtering by type, lifecycle stage, owner, and text search. Returns contacts with id, name, email, phone, type, lifecycle_stage, company, and timestamps. Use this when the user asks to see their contacts, find a person, or list companies. Also use this with the 'q' parameter to search for existing contacts BEFORE creating new ones to prevent duplicates.

  • create_contactActs

    Create a new CRM contact (person or company). Persons can be linked to a company via company_id. IMPORTANT: Before creating a contact, ALWAYS call list_contacts with a search query (q) to check if a contact with the same name or email already exists. If a matching contact is found, use update_contact instead of creating a duplicate. Only create a new contact if no match is found. Use this when the user asks to add a contact, log a lead, or create a company record.

  • batch_get_contactsRead-only

    Fetch multiple CRM contacts by their IDs in a single request (max 100). Missing or inaccessible IDs are silently omitted from the result.

  • merge_contactsDestructive

    Merge two CRM contacts that represent the same person/company. The secondary contact is deleted, and its activities and deals are re-linked to the primary. Use this when you discover duplicates (same email or name). The primary contact is the one kept; the secondary is removed.

  • bulk_delete_contactsDestructive

    Delete many CRM contacts in a single operation. Returns counts of deleted/skipped/failed items.

  • bulk_update_contactsActs

    Update many CRM contacts in a single operation. Useful for re-assigning ownership, updating lifecycle stage on a list of contacts, or reclassifying industry. Provide an array of contact IDs and the fields to apply to all of them.

  • bulk_export_contactsRead-only

    Export selected contacts as CSV or vCard. CSV includes core fields and custom properties; vCard preserves imported RFC 6350 properties and parameters.

  • get_contactRead-only

    Get a single CRM contact by ID, including full details: name, email, phone, title, company, lifecycle stage, custom properties, and timestamps. If the user is currently viewing a contact, use the contact ID from the page context.

  • update_contactActs

    Update an existing CRM contact's fields. Provide only the fields you want to change. For interrupted sync recovery, read the contact and send expected_updated_at with only remaining changes. A 409 carrying contact_id means another contact already has that email; any other 409 means the contact changed: read again and reconcile; never replay an earlier snapshot over newer values. If the user is currently viewing a contact, use the contact ID from the page context.

  • delete_contactDestructive

    Delete a CRM contact (owner-scoped). Permanently removes the contact record. Use with caution — prefer updating lifecycle_stage to 'evangelist' or archiving via merge instead.

  • list_contact_activitiesRead-only

    List activities (notes, calls, emails, meetings, tasks) on a specific contact's timeline. Useful for summarizing recent interactions with a contact before sending an email or making a call.

  • get_contact_scoreRead-only

    Get a contact's current lead score with a breakdown of which scoring rules matched and how many points each contributed. Use this to explain why a contact is hot/cold.

  • crm_contact_files_listRead-only

    List files attached to a contact

  • crm_contact_file_attachActs

    Copy a readable Drive file into a contact-owned attachment. The copy is readable by the contact readers; the original file and its sharing remain unchanged. A native doc, sheet, deck, canvas or form without stored bytes returns 422 `native_document_not_copyable`; attach it as a link.

  • crm_contact_file_detachDestructive

    Detach a file from a contact

  • crm_contact_photo_getRead-only

    Serve the photo image stored for a CRM contact.

  • delete_contact_photoDestructive

    Delete a CRM contact's profile photo. Clears the avatar_url and removes the stored image.

  • list_contact_groupsRead-only

    List all contact groups in the workspace with their member counts. Groups are named collections for organizing contacts (e.g., 'Conference leads 2026').

  • create_contact_groupActs

    Create a named contact group for organizing contacts. Groups allow overlapping membership — a contact can be in multiple groups.

  • update_contact_groupActs

    Update an existing contact group's name, color, or sort order. Group name must remain unique within the workspace.

  • delete_contact_groupDestructive

    Delete a contact group. Memberships are removed but contacts themselves are preserved.

  • list_contact_group_membersRead-only

    List all contacts that are members of a contact group. Returns the contact id, name, email, and type for each member.

  • modify_contact_group_membersActs

    Bulk add or remove contacts from a contact group. Idempotent — adding an already-present contact or removing an absent one is a no-op.

  • list_dealsRead-only

    List CRM deals. Supports filtering by pipeline, stage, and status. Returns deals with id, title, amount, currency, stage, pipeline, contact, status, and timestamps. Use this when the user asks to see their deals, check the pipeline, or find opportunities.

  • create_dealActs

    Create a new CRM deal (revenue opportunity). Deals belong to a pipeline and sit in a specific stage. Link to a contact and/or company. Use this when the user asks to create a deal, log an opportunity, or start tracking a sale.

  • batch_get_dealsRead-only

    Fetch multiple CRM deals by their IDs in a single request (max 100). Missing or inaccessible IDs are silently omitted from the result.

  • get_dealRead-only

    Get a single CRM deal by ID, including full details: title, amount, currency, stage, pipeline, contact, company, owner, probability, close date, custom properties, and timestamps. Pass embed=line_items to include the full line-items array. If the user is currently viewing a deal, use the deal ID from the page context.

  • update_dealActs

    Update an existing CRM deal's fields. Provide only the fields you want to change. Use this to move a deal to a new stage, update the amount, mark as won/lost, etc. If the user is currently viewing a deal, use the deal ID from the page context.

  • delete_dealDestructive

    Delete a CRM deal (owner-scoped). Permanently removes the deal record and its line items. Prefer updating status to 'lost' with a lost_reason for reporting purposes.

  • crm_deal_activitiesRead-only

    List activities for deal (owner-scoped)

  • bulk_delete_dealsDestructive

    Delete many CRM deals at once by their ids.

  • bulk_update_dealsActs

    Update many CRM deals in a single operation. Useful for moving multiple deals to a new stage, reassigning ownership, or marking a batch of deals as won/lost. Provide an array of deal IDs and the fields to apply.

  • bulk_export_dealsRead-only

    Export selected deals as CSV

  • list_deal_line_itemsRead-only

    List all line items for a deal, plus the computed total.

  • add_deal_line_itemActs

    Add a line item to a deal. Either reference an existing product (via product_id) or create a custom line by providing name and unit_price. The deal amount is auto-recalculated.

  • update_deal_line_itemActs

    Update a deal line item (quantity, price, discount, name/description). Amount auto-recomputed. If sync_deal_amount defaults true, the deal's total is also refreshed.

  • delete_deal_line_itemDestructive

    Delete a deal line item. By default the deal's total amount is re-synced after deletion.

  • crm_deal_files_listRead-only

    List files attached to a deal

  • crm_deal_file_attachActs

    Copy a readable Drive file into a deal-owned attachment. The copy is readable by the deal readers; the original file and its sharing remain unchanged. A native doc, sheet, deck, canvas or form without stored bytes returns 422 `native_document_not_copyable`; attach it as a link.

  • crm_deal_file_detachDestructive

    Detach a file from a deal

  • list_deal_templatesRead-only

    List deal templates in the workspace (reusable deal presets: default pipeline, stage, amount, probability, and line items).

  • get_deal_templateRead-only

    Get a single deal template with its line items and resolved pipeline/stage names.

  • create_deal_templateActs

    Create a deal template — a reusable preset for creating deals with standard pipeline/stage/amount and line items. Use when the user has a repeatable sale like 'Standard Enterprise Plan'.

  • update_deal_templateDestructive

    Update a deal template. Providing `line_items` replaces the entire line-item list.

  • delete_deal_templateDestructive

    Delete a deal template (does not affect deals previously created from it).

  • apply_deal_templateActs

    Create a new deal from a saved deal template. The template provides default pipeline, stage, amount, probability, and line items. Use this when starting a deal that matches a known pattern (e.g., 'Standard Enterprise Plan').

  • list_pipelinesRead-only

    List all CRM pipelines with their stages. Each pipeline contains an ordered list of stages with names, sort order, and default probabilities. Use this before creating or moving deals to find valid pipeline_id and stage_id values.

  • create_pipelineActs

    Create a new CRM pipeline with ordered stages. Each stage has a name and an optional default probability (0-100). Most workspaces need only one pipeline; create additional ones for distinct sales processes (e.g., 'New Business' vs 'Renewals').

  • get_pipelineRead-only

    Get a single CRM pipeline by ID with its ordered stages and its `visibility` — `workspace` when the pipeline is shared with the whole workspace, `private` when only its members reach its deals. A caller who is not a member receives 404.

  • update_pipelineDestructive

    Update a pipeline's name or stages. Providing `stages` replaces the entire stage list — include every stage you want to keep. Reordering is done by the order in the array.

  • delete_pipelineDestructive

    Delete a CRM pipeline and all of its stages. Deals in the pipeline must be moved or deleted first.

  • get_crm_analyticsRead-only

    Get analytics for accessible deals, optionally scoped to one pipeline: pipeline value by stage, conversion rates, average deal size, sales velocity, and deals breakdown.

  • list_pipeline_membersRead-only

    List the members of a CRM pipeline. Deal visibility is pipeline membership: a deal is visible to admins/owners and to members of its pipeline (directly or via a team). Roles are admin (can manage the pipeline + members) or member.

  • add_pipeline_memberDestructive

    Add (or update the role of) a user or team on a CRM pipeline. Provide either user_id or team_id, plus role (admin | member). Admins/owners and pipeline admins can manage members.

  • remove_pipeline_memberDestructive

    Remove a user or team from a CRM pipeline. The principalId is the user_id or team_id of the member to remove.

  • list_crm_activitiesRead-only

    List recent CRM activity visible to the current user across contact and deal timelines.

  • log_activityActs

    Log an activity on a CRM contact or deal timeline. Activities track interactions like calls, emails, meetings, notes, and tasks. Use this when the user asks to log a call, record meeting notes, or add a note to a contact/deal.

  • get_activityRead-only

    Get a single activity by ID. Useful for reading back a just-created activity via the resource URL in the activity.created event payload.

  • delete_activityDestructive

    Delete one logged CRM activity by id.

  • list_sequencesRead-only

    List all CRM email/task sequences (multi-step automated outreach campaigns). Returns sequences with their steps, active status, and current enrollment count.

  • create_sequenceActs

    Create a multi-step CRM sequence (email/wait/task/call/branch steps). Use this when the user asks to build a nurture campaign or outreach cadence.

  • get_sequenceRead-only

    Get a single sequence with its full step list and current enrollment count.

  • delete_sequenceDestructive

    Delete a sequence (and all its enrollments).

  • list_sequence_enrollmentsRead-only

    List all enrollments for a sequence, including each contact's current step, status, and next execute time. Useful for checking progress or finding an enrollment ID to unenroll.

  • unenroll_contact_from_sequenceDestructive

    Permanently remove a contact from a CRM sequence (terminal — sets status to 'unenrolled'). The contact will not receive any further sequence steps. Returns 409 if already in a terminal status. Provide the enrollment ID (not the contact ID — find it via list_sequence_enrollments).

  • list_enrollment_eventsRead-only

    Get the event log for a single sequence enrollment (step-executed, email-opened, email-replied, branch-taken, completed). Useful for auditing why a contact moved to a particular step.

  • list_scorable_fieldsRead-only

    List the contact fields that can be used in scoring rules (lifecycle_stage, industry, title, website, custom_properties.*, etc.) and the operators each supports.

  • recalculate_lead_scoresActs

    Recalculate lead scores for all contacts in the workspace. Use this after creating or updating scoring rules so existing contacts pick up the new scoring.

  • list_scoring_rulesRead-only

    List all lead scoring rules for the workspace.

  • create_scoring_ruleActs

    Create a lead scoring rule. When a contact matches (field + operator + value), the specified points are added to their lead score. Positive points indicate engagement; negative points indicate disqualification signals.

  • update_scoring_ruleActs

    Update a lead scoring rule (name, field, operator, value, points, is_active).

  • delete_scoring_ruleDestructive

    Delete a lead scoring rule.

  • list_quotesRead-only

    List CRM quotes/proposals. Filter by status (draft, sent, accepted, rejected, expired), deal, or contact. Useful for finding outstanding quotes or recently-accepted ones.

  • create_quoteActs

    Create a CRM quote (proposal) with line items. Auto-computes subtotal, tax, discount, and total. Link to a deal/contact/company via IDs. Status defaults to 'draft' — use send_quote to email it.

  • get_quoteRead-only

    Get a single CRM quote with its line items and linked deal/contact/company/owner.

  • update_quoteDestructive

    Update a CRM quote. Providing `line_items` replaces the entire line-item list. Totals are auto-recomputed.

  • delete_quoteDestructive

    Delete a CRM quote and its line items.

  • send_quoteDestructive

    Send a CRM quote via email to the contact. Marks the quote as 'sent'. By default, sends to the linked contact's email address.

  • crm_quote_pdfRead-only

    Export quote as PDF (or printable HTML with ?format=html)

  • list_productsRead-only

    List products in the workspace catalog. Use this when the user asks about pricing or available SKUs, or before adding a product as a deal line item.

  • create_productActs

    Create a product in the workspace catalog. Products are the reusable items that can be attached to deal line items and quote line items. Set is_active=false to retire without deleting.

  • get_productRead-only

    Get one CRM product from the catalog by id.

  • update_productActs

    Update a CRM product's name, price or other fields.

  • delete_productDestructive

    Delete a product from the workspace catalog. Existing deal/quote line items referencing it are NOT deleted, but their product_id is nulled.

  • list_crm_viewsRead-only

    List the user's saved CRM views (filter + sort presets for contacts/companies/deals). Views personalize how CRM data is displayed without changing the underlying records.

  • create_crm_viewActs

    Create a saved CRM view: a named filter+sort preset for contacts, companies, or deals. Useful when the user asks to 'save this filter' or 'create a view for high-value deals'.

  • update_crm_viewActs

    Update a saved CRM view (rename, change filters, toggle default/shared).

  • delete_crm_viewDestructive

    Delete a saved CRM view.

  • list_scheduler_linksRead-only

    List the user's scheduler links (Calendly-style booking pages). Each link has a shareable slug, duration, availability hours, and optionally auto-creates a contact + deal when booked.

  • create_scheduler_linkActs

    Create a scheduler link (booking page). Returns the public URL slug and availability settings. If auto_create_contact is true, every booking auto-creates a CRM contact + deal.

  • get_scheduler_linkRead-only

    Get a single scheduler link (owner-scoped) with its settings and booking count.

  • update_scheduler_linkDestructive

    Update a scheduler link (rename, change availability, toggle active, etc.).

  • delete_scheduler_linkDestructive

    Delete a scheduler link. Existing confirmed bookings remain but the public booking page stops accepting new bookings.

  • list_scheduler_link_bookingsRead-only

    List all bookings for a single scheduler link (owner-scoped).

  • list_scheduler_bookingsRead-only

    List all bookings (across all scheduler links) owned by the current user. Useful for summarizing the user's upcoming meetings.

  • cancel_scheduler_bookingDestructive

    Cancel a booking as its host. The booked event is cancelled and the booker is always emailed the cancellation, with the optional message.

  • list_formsRead-only

    List the user's forms. Returns forms with id, title, slug, is_published, response count, timestamps, and the caller's own star and Drive tags. Pass `starred=true` for only the forms you starred. Use this when the user asks to see their forms, find a specific form, or check form status.

  • create_formActs

    Create a new form for collecting data (surveys, feedback, registrations, quizzes). Returns the created form with id and public slug. Use this when the user asks to create a survey, questionnaire, feedback form, registration form, or any structured data collection. Define fields with types, labels, validation, and optional conditional logic. is_published=true immediately opens the responder link to public responses.

  • list_form_responsesRead-only

    List responses submitted to a form. Returns responses with respondent info, submitted data (keyed by field ID), and timestamps. Use this when the user asks to see form results, check submissions, analyze feedback, or export response data.

  • export_form_responsesRead-only

    Download all matching form responses as CSV with field labels, display values, blank unanswered cells, and ISO submission timestamps. Streams beyond the response-list page size.

  • get_form_responseRead-only

    Get a single form response by ID. Returns respondent info, submitted data (keyed by field ID), and timestamp. Use when the user asks about a specific submission or wants to review a particular response.

  • delete_form_responseDestructive

    Delete a single form response. This is destructive — always confirm with the user before executing. Use when the user asks to remove or delete a specific submission.

  • list_form_variantsRead-only

    List A/B test variants for a form. Returns each variant's id, name, traffic weight, active status, and variant form ID. Use when the user asks about their A/B tests, variant list, or experiment setup.

  • create_form_variantActs

    Create a new A/B test variant by duplicating the parent form. Optionally override fields to change question wording, field types, options, or validation. The variant inherits the parent's publish state. Traffic weight (0–100) controls the percentage of visitors who see this variant versus the control. Use when the user asks to set up an A/B test or add a variant.

  • update_form_variantActs

    Update an A/B test variant's name, traffic weight, or active status. Use when the user asks to rename a variant, adjust the traffic split, or pause/resume an experiment.

  • delete_form_variantDestructive

    Delete an A/B test variant (and its underlying duplicated form). Destructive — always confirm with the user. Use when the user asks to remove a variant or end an experiment.

  • get_form_analyticsRead-only

    Get analytics for a form: total views, total responses, completion rate, average completion time, responses-by-day (last 30 days), per-field drop-off funnel, and per-field summaries (option counts for select fields, numeric stats for rating/number fields). Use when the user asks about form performance, response rate, completion rate, or field-level statistics.

  • get_form_ab_analyticsRead-only

    Get A/B test comparison analytics for a form with variants. Returns control + each variant with views, responses, completion rate, and traffic weight. Use when the user asks which variant is winning, for A/B test results, or experiment performance comparison.

  • publish_formActs

    Publish a form so it accepts public responses. Semantic shortcut for PATCH /api/forms/{id} with is_published=true; same validation (every field needs a non-empty label).

  • unpublish_formActs

    Unpublish a form so it stops accepting public responses. Semantic shortcut for PATCH /api/forms/{id} with is_published=false.

  • get_formRead-only

    Get a form's full details including field schema, settings, publish status, and slug. Use this when the user asks about a form's fields, structure, or configuration. If the user is currently viewing a form, use the resource ID from page context. is_published changes public response availability; fields replaces the question list.

  • update_formDestructive

    Update an existing form's title, description, fields, settings, or publish status. Use this when the user asks to edit a form, add/remove fields, publish/unpublish, or change form settings. If the user is currently viewing a form, use the resource ID from page context. is_published changes public response availability; fields replaces the question list.

  • delete_formDestructive

    Delete a form and all its responses. This is a destructive action — always confirm with the user before executing. Use this when the user explicitly asks to delete or remove a form.

  • get_calendar_colorsRead-only

    Get the available color palette for calendars and events. Returns 24 calendar colors and 11 event colors, each with a background and foreground hex value. Use this when the user asks what colors are available, or before setting a calendar or event color.

  • check_availabilityRead-only

    Check free/busy availability for one or more users in a given time range. Returns busy time slots (not event details) for each user. Use this when the user asks to find a free time, check if someone is available, or schedule a meeting. Call this before create_event to avoid scheduling conflicts.

  • calendar_conflictsRead-only

    Detect attendee scheduling conflicts.

  • get_ooo_statusRead-only

    Check out-of-office status for one or more users. Returns per-user OOO flag and event details when applicable. Call this before scheduling to avoid inviting people who are OOO.

  • calendar_attendee_identityRead-only

    Resolve an attendee identifier to a current workspace member without changing the event or exposing foreign identities.

  • calendar_upcoming_remindersRead-only

    Reminders due to fire within the next `window_hours` (default 24, max 168), soonest first. Each row carries the event it is about — title, span, status, location and calendar — so the caller renders the row without a second fetch.

  • list_calendarsActs

    List the user's calendars, creating their default calendar if none exists. Returns calendar id, name, color, timezone, and whether it's the default. Use this to find the user's default calendar ID before creating events.

  • calendars_createActs

    Create a calendar in the current workspace.

  • calendar_external_auth_urlRead-only

    Start external provider OAuth.

  • calendar_external_connections_listRead-only

    List connected external accounts.

  • calendar_external_connection_deleteDestructive

    Disconnect external account.

  • calendar_external_calendars_listRead-only

    List calendars on connection.

  • calendar_external_calendars_enable_syncActs

    Enable two-way sync.

  • calendar_external_force_syncActs

    Schedule an immediate background pull for this connection. A 202 response accepts the request; it does not report completion. Poll the connection's sync_state for the returned request_id until completed or failed. last_sync_at can advance during partial failure and is not a completion signal. Concurrent requests share the active request_id.

  • calendar_external_synced_disableDestructive

    Disable sync for one calendar.

  • list_eventsRead-only

    List calendar events across all of the user's calendars. Supports filtering by date range, calendar, and free-text search. Returns events with id, title, start/end times, location, status, and attendees. Use this when the user asks to see their schedule, upcoming meetings, or events for a date. Use the q parameter to search for events by keyword (matches title, description, location, and attendee names).

  • list_calendar_eventsRead-only

    List events scoped to a single calendar by its id — the RESTful path variant of list_events (`/api/calendars/events?calendar_id=…`). Requires at least viewer access to the calendar.

  • search_calendar_eventsRead-only

    Full-text search across all calendar events for the current workspace. Returns matching events with id, title, start/end times, and calendar info. Use this when the user asks to find a specific event by name or description keyword.

  • create_eventDestructive

    Create a new calendar event. Requires a title, start time, and end time. Optionally add a description, location, attendees, recurrence, and more. Use this when the user asks to schedule a meeting, add an event, or book time. If the user doesn't specify a calendar, use list_calendars to find their default calendar ID first.

  • get_eventRead-only

    Get a single calendar event by ID, including full details: title, description, location, start/end times, recurrence rule, status, visibility, and attendees with RSVP status. For a recurring master, occurrence_start_at selects an occurrence by its original recurrence instant, retaining a saved occurrence's own ID after rescheduling. If the user is currently viewing an event, use the event ID from the page context.

  • get_event_instancesRead-only

    List individual occurrences of a recurring event within a date range. Expands the RRULE server-side and returns instance objects with computed start/end times. Use this to find specific occurrences (e.g., 'what meetings are on next Tuesday?') or to list upcoming instances of a series.

  • update_eventDestructive

    Update an existing calendar event. Provide only the fields you want to change. Use this to reschedule, change attendees, update the description, or cancel an event. If the user is currently viewing an event, use the event ID from the page context.

  • delete_eventDestructive

    Delete a calendar event. This is a destructive action — always confirm with the user before calling. If the user is currently viewing an event, use the event ID from the page context. Guests are emailed a cancellation only when `send_updates` asks for it.

  • rsvp_eventActs

    RSVP to a calendar event that the user is invited to. Use this when the user asks to accept, decline, or mark tentative on an event invitation.

  • calendar_event_export_icsRead-only

    Export single event as .ics.

  • edit_recurring_event_singleDestructive

    Edit a single occurrence of a recurring event, creating an exception without affecting other occurrences. Use this when the user says 'move just next Tuesday's meeting to 3pm' or 'cancel only this one occurrence'.

  • edit_recurring_event_futureDestructive

    Edit this and all future occurrences of a recurring event by splitting the series at the given date. Use this for 'change the meeting time from next week onwards' or 'update our recurring Friday sync starting next month'.

  • edit_recurring_event_allDestructive

    Edit all occurrences in a recurring series. Updates the master event.

  • delete_recurring_event_singleDestructive

    Delete a single occurrence of a recurring event by adding the occurrence date to the master's excluded_dates. The occurrence is suppressed without affecting other instances.

  • delete_recurring_event_futureDestructive

    Delete this and all future occurrences of a recurring event by adding an UNTIL clause to the master's RRULE, ending the series the day before the given split_date. When no occurrence starts before split_date, the whole series (master and every exception) is deleted instead.

  • book_event_resourcesActs

    Book one or more resources (rooms, equipment) for an existing event. Returns a conflict error if a resource is already booked.

  • calendar_event_unbook_resourcesDestructive

    Release every resource booked for a calendar event.

  • list_event_resourcesRead-only

    List resources currently booked for an event (rooms, equipment).

  • calendar_event_reminders_listRead-only

    List event reminders.

  • calendar_event_reminders_createActs

    Add a reminder to a calendar event.

  • calendar_event_reminders_setDestructive

    Replace reminder list.

  • calendar_event_meeting_notes_createActs

    Create a meeting-notes doc for an event, or — when `document_id` is given — link that existing doc and grant attendees access.

  • calendar_event_meeting_notes_unlinkDestructive

    Unlink meeting-notes doc.

  • list_resourcesRead-only

    List bookable resources (rooms, equipment) in the workspace. Call before booking a room to see what's available.

  • calendar_resources_createActs

    Create a bookable resource.

  • calendar_resource_getRead-only

    Get one bookable calendar resource by id.

  • calendar_resource_updateActs

    Update a bookable calendar resource's details.

  • calendar_resource_deleteDestructive

    Delete a bookable calendar resource by id.

  • check_resource_availabilityRead-only

    Check if a specific resource (room, equipment) is free in a time range. Call before booking to avoid conflicts.

  • calendar_reminder_deleteDestructive

    Delete one calendar event reminder by id.

  • calendars_permissions_getRead-only

    Get a single user's permission entry on a calendar, including their role, display name, and email. Useful for checking if a specific user has access without listing all permissions.

  • rotate_calendar_publish_urlDestructive

    Rotate a published calendar's read-only subscription URL. The previous URL is revoked immediately.

  • unpublish_calendarDestructive

    Revoke the public .ics feed for a calendar, making it private again.

  • calendar_import_ics_urlDestructive

    Import an .ics feed by URL. Fetches the URL server-side and imports its events into the calendar.

  • calendar_export_icsRead-only

    Export entire calendar as .ics.

  • clear_calendarDestructive

    Delete ALL events from a calendar. Owner-only — use for resetting shared calendars at quarter boundaries or wiping test data. Returns the count of deleted events. This is irreversible.

  • get_calendarRead-only

    Get a single calendar by ID. Returns the calendar's name, color, timezone, default status, and owner. Use this when the user asks about a specific calendar's settings or before creating events to verify the timezone.

  • calendars_updateActs

    Update calendar fields.

  • calendars_deleteDestructive

    Delete a calendar and every event on it.

  • wiki_native_backupRead-only

    Export a separately labeled, digest-bound native Wiki backup containing the workspace Wiki graph and page-owned image metadata and bytes. This is not DOCX.

  • wiki_native_restoreActs

    Restore a native Wiki backup into its empty source workspace. Preserves spaces, hierarchy, page content, databases, backlinks, synced blocks, permissions, versions, comments, and v2 page-owned images. Historical v1 backups contain only the graph.

  • list_wiki_spacesRead-only

    List all wiki spaces. Returns spaces with id, name, slug, description, icon, owner info, privacy setting, and page count. Use this when the user asks to see wiki spaces, browse the knowledge base, or when you need a space ID to create a page.

  • create_wiki_spaceActs

    Create a new wiki space (a top-level container for pages). Use this when the user asks to create a new knowledge base area, team wiki, or documentation section. Spaces organize pages by team or domain (e.g., 'Engineering', 'Product', 'Company Handbook').

  • wiki_space_members_listRead-only

    List distinct members of a space — the owner plus everyone with a page-level permission inside it.

  • wiki_space_member_addActs

    Add a user as a direct member of a wiki space with a given role.

  • wiki_space_member_removeDestructive

    Remove a direct member from a wiki space.

  • get_wiki_space_graphRead-only

    Get backlink graph data for a wiki space. Returns nodes (pages) and edges (links between pages). Use this when the user asks to visualize the knowledge graph, see how pages connect, or find highly-linked 'hub' pages.

  • list_wiki_space_pagesRead-only

    List pages in a wiki space with offset/limit pagination. Returns page summaries (id, title, slug, icon, parent_page_id, sort_order). Use this when the user asks to see all pages in a space, or when you need to paginate through a large space.

  • create_wiki_pageActs

    Create a new wiki page within a space. Pages use Markdown content and support nested hierarchies via parent_page_id. Use this when the user asks to create a wiki page, add documentation, write a runbook, or add to the knowledge base. Call list_wiki_spaces first to get the space ID.

  • wiki_space_getRead-only

    Get a wiki space by slug, with its full page tree. Supports cursor pagination on `pages`.

  • wiki_space_updateDestructive

    Update a wiki space. Only the space owner may change settings.

  • wiki_space_deleteDestructive

    Delete a wiki space and all of its pages.

  • wiki_trash_listRead-only

    List trashed (soft-deleted) wiki pages in the workspace.

  • wiki_page_restoreActs

    Restore a trashed wiki page and its children.

  • wiki_page_children_listRead-only

    List the immediate child pages of a wiki page. Use this to traverse the page tree one level at a time, or to count children before a destructive delete.

  • wiki_page_backlinks_listRead-only

    List wiki pages that contain `[[link]]` references to this page. Use this to see what pages cite a given page, or to find inbound knowledge links.

  • wiki_page_asset_createActs

    Add an image to wiki body/cover. Returns the parent-owned image URL `/api/assets/{id}/content`. Input: content_base64 bytes, source_file_id (copies a viewable Drive file), or source_url (copies public HTTPS through SSRF guard); no source link retained. Native sources without stored bytes return 422 native_document_not_copyable; attach it as a link. Byte-sniffed images only, 415 for other types or malformed SVG. SVG sanitized on upload and every read, inline image/svg+xml with restrictive CSP; malformed stored SVG returns 404. Drive SVG stays attachment. Owner quota exceeded 413; same image deduplicated per parent. Absent from Drive, readable exactly with parent.

  • list_wiki_page_versionsRead-only

    List the saved version snapshots for a wiki page (most recent first). Use this when the user asks for revision history, wants to see who edited and when, or needs to find a version to revert to.

  • create_wiki_page_versionActs

    Create a manual snapshot of the current wiki page state. Useful before a risky edit or when the user wants to mark a 'known good' checkpoint. Optional `label` names the snapshot. Returns the new version's id + metadata.

  • get_wiki_page_versionRead-only

    Get a wiki page version's full content (title + markdown body). Use this when the user asks what a previous version looked like, wants to compare versions, or needs the content of a specific snapshot.

  • revert_wiki_page_versionActs

    Revert a wiki page to a previous version snapshot. This replaces the current content with the version's content and rebuilds the page's collaborative state from it. A snapshot of the current state is automatically created before reverting. This is destructive for the in-progress edit — always confirm with the user first.

  • wiki_page_duplicateActs

    Duplicate a wiki page (and optionally its descendants) into a target space + parent. Returns the new top-level page.

  • wiki_page_exportRead-only

    Export a wiki page to docx, pdf, html, or md. Streams the file with a Content-Disposition attachment header.

  • list_wiki_page_databasesRead-only

    List all inline databases hosted on a wiki page.

  • wiki_page_database_createActs

    Create an inline database on a specific wiki page.

  • wiki_page_tasks_adoptActs

    Move the caller's project-less tasks linked from this wiki page into `project_id`; set the page's tasks project if unset. Other linked tasks are listed in `skipped` and unchanged.

  • get_wiki_pageRead-only

    Get a wiki page's full details including Markdown content, child pages, backlinks (pages that link to this page), and metadata. Use this when the user asks about a page's content, wants to read documentation, or needs to check what links to a specific page. If the user is currently viewing a wiki page, use the resource ID from page context.

  • update_wiki_pageActs

    Update an existing wiki page's content, title, icon, or parent. Use this when the user asks to edit a wiki page, update documentation, or move a page to a different parent. If the user is currently viewing a wiki page, use the resource ID from page context.

  • delete_wiki_pageDestructive

    Move a wiki page to Trash, together with every page beneath it. Trashed pages leave the tree and search, and can be brought back with `wiki_page_restore`; only `wiki_page_permanent_delete` removes them for good. A page that has child pages answers 409 with `requires_cascade` and `children_count` unless `cascade=true` is passed, so confirm with the user before trashing a sub-tree. Use this when the user asks to delete or remove a wiki page.

  • search_wikiRead-only

    Case-insensitive substring search across wiki page titles and Markdown content. Returns only pages the caller can view under the effective page-to-space permission rules, with id, title, space, and content snippets. Use this when the user asks to find information in the wiki, look up documentation, or search the knowledge base. More efficient than reading individual pages.

  • wiki_database_createActs

    Create an inline database on a wiki page. Requires editor role on the host page.

  • wiki_database_row_createActs

    Append a row to an inline database. Requires editor role on the host page. Set a person property to a user id from the users list; other text is stored and shown as written.

  • wiki_database_row_updateActs

    Update properties or sort order on a database row. Properties merge: named properties change, others stay, and null clears one. Set a person property to a user id from the users list; other text is stored and shown as written.

  • wiki_database_row_deleteDestructive

    Delete a database row.

  • get_wiki_database_rowRead-only

    Get a single database row by id.

  • query_wiki_databaseRead-only

    Query rows from an inline database with optional view, filter, and sort. Returns paginated results.

  • ensure_wiki_reverse_relationActs

    Auto-create the reverse relation property on the target database if missing. Idempotent — returns the existing or newly-created reverse property id.

  • compute_wiki_rollupsRead-only

    Compute and return rollup values for all rows in the database. Each rollup aggregates a property across related rows.

  • wiki_database_getRead-only

    Get an inline database with its full row set.

  • wiki_database_updateActs

    Update an inline database's name, schema, or views. Requires editor role on the host page.

  • list_wiki_synced_blocks_by_pageRead-only

    List synced blocks that were originally created on a specific page. Use this when the user asks what shared content a page publishes, or to audit reuse.

  • create_wiki_synced_blockActs

    Create a synced block — a reusable content fragment that can be embedded in multiple wiki pages and stays in sync everywhere it's used. Returns the new block's id. Use this when the user asks to create a shared snippet, reusable callout, or cross-page content.

  • get_wiki_synced_blockRead-only

    Get a synced block by ID. Returns the block's content and metadata. Use this when you need to read the current content of a shared block.

  • update_wiki_synced_blockActs

    Update a synced block's content. All pages embedding this block will reflect the new content. Use this when the user asks to edit shared content or update a reusable snippet.

  • delete_wiki_synced_blockDestructive

    Soft-delete a synced block. Embedded references will show error chips until restored. Use restore_wiki_synced_block to undo.

  • restore_wiki_synced_blockActs

    Restore a previously deleted synced block. Embedding pages will render the block again instead of showing error chips.

  • asset_get_contentRead-only

    Get parent-owned image bytes for doc/sheet/deck/board/wiki/task, absent from Drive. Readable exactly by parent role/access, including external collaborators. Proxied, no redirect; Cache-Control:no-store. Active types including SVG and Canvas HTML download as attachments. With canvas_embeds off, HTML returns 404 module_unavailable; missing, inaccessible or invalid assets return 404. Transient storage failures return 503 asset_storage_unavailable with Retry-After.

  • get_workspaceRead-only

    Get the current workspace details (id, name, slug). Requires admin role.

  • update_workspaceActs

    Update workspace name or slug. Requires admin role.

  • admin_workspace_logo_deleteDestructive

    Remove workspace logo (admin only)

  • get_settingsRead-only

    Get all workspace settings. Requires admin role.

  • update_settingsActs

    Update workspace settings (name, logo, timezone, etc.). Requires admin role. Pass a flat key-value object.

  • get_security_settingsRead-only

    Get workspace security settings (require_2fa, session_timeout_hours, password_min_length, ip_allowlist). Requires admin role.

  • admin_notification_defaults_getRead-only

    Read workspace-default email notification prefs. Returns sensible defaults (all enabled) when never configured.

  • admin_notification_defaults_updateActs

    Partially update workspace-default email notification prefs. Emits settings.updated audit event.

  • get_email_signatureRead-only

    Get the workspace default email signature (Markdown). Requires admin role.

  • set_email_signatureActs

    Set the workspace default email signature. Pass null (or omit markdown) to clear. Requires admin role.

  • get_email_deliverabilityRead-only

    Get email deliverability statistics (sent/bounced/complained/opened rates) for the past 30 days. Requires admin role.

  • list_usersRead-only

    List workspace members and agents with identity, role, status, storage usage, and timestamps. Requires admin or owner.

  • admin_user_getRead-only

    Get one workspace user's full admin record by id.

  • update_userActs

    Update a member's display name, username, avatar, storage quota, or workload capacity. Requires admin or owner. Change roles with assign_role/remove_role; suspend or restore access with admin_user_suspend/admin_user_unsuspend.

  • get_account_erasure_outcomeRead-only

    Read a deleted member's durable erasure outcome and notice-delivery state. Requires admin or owner.

  • admin_user_reset_passwordDestructive

    Email the member a one-hour password-reset link. When the send fails, `sent` is false with `error: "delivery_failed"`. The link itself is returned only to a REST caller, never to an AI tool surface.

  • admin_invites_listRead-only

    List pending, accepted, and expired workspace invites, pending first and then newest. Paginated; `pending_total` counts invites awaiting acceptance. Each row also carries `delivery` — what the provider said about the latest send of that invite email, so a bounced invite is distinguishable from an ignored one.

  • list_rolesRead-only

    List all roles in the workspace (system roles + custom roles). Requires admin role.

  • get_usage_statsRead-only

    Get workspace usage statistics including storage breakdown by user and module, active user count, API call volume, and per-module adoption metrics. Requires admin or owner role. Use this when the user asks about workspace usage, storage consumption, billing metrics, or capacity planning.

  • admin_usage_timeseriesRead-only

    Daily creation counts (last 14 days, split into "last 7" + "prior 7" windows) for the four hero metrics on the Overview tab. Returns `{users, documents, messages, emails}` each with `{buckets[7], total, previous_total}` so the UI can draw a sparkline + render a 7...

  • admin_usage_exportRead-only

    Export usage stats as CSV

  • verify_domainActs

    Trigger DNS verification for a workspace domain. Requires admin role.

  • verify_domain_ownershipActs

    Verify custom domain ownership via DNS TXT record. On success, auto-registers with SES to retrieve DKIM/SPF records. Requires admin role.

  • send_test_notification_emailDestructive

    Send a test notification email (useful for checking email rendering and deliverability). Requires admin role.

  • admin_mail_suppressions_listRead-only

    list suppressed addresses

  • admin_mail_suppression_createActs

    manually add a suppression

  • admin_mail_suppression_deleteDestructive

    Clear a bounce once the address is fixed. An unsubscribe or spam complaint is lifted only by the recipient, so clearing one is refused with 409 suppression_recipient_controlled; clearing a bounce on an address that also unsubscribed keeps the unsubscribe.

  • admin_integrations_listRead-only

    list all integrations for workspace

  • admin_integrations_slack_channelsRead-only

    list Slack channels via bot token

  • admin_integration_updateActs

    update integration config

  • admin_integration_deleteDestructive

    disconnect an integration

  • get_account_mail_client_settingsRead-only

    The caller's IMAP, SMTP-submission and CalDAV settings as data — the same username, hosts and ports the `.mobileconfig` encodes, for a mail client no Apple profile covers. Hosts come from `@ambiguous/topology`, so no client carries a hostname literal. Gated exactly like the profile: 400 when the account has no Ambiguous password or no resolvable workspace address, because either makes the settings unusable.

  • get_current_workspaceRead-only

    Get the active workspace (name, slug, logo, scheduling timezone). Accessible to any authenticated user.

  • check_workspace_slugRead-only

    Check whether a workspace slug is available.

  • list_my_workspacesRead-only

    List workspaces the current user belongs to (human users may have multiple). Returns workspace id, name, slug, role, and which one is active.

  • webhooks_event_typesRead-only

    List event types an agent can subscribe to. Includes the `*` wildcard.

  • webhooks_listRead-only

    List webhook registrations owned by the caller.

  • webhooks_getRead-only

    Get one webhook subscription's config by id.

  • webhooks_deleteDestructive

    Delete one webhook subscription by id.

  • webhooks_deliveries_listRead-only

    List recent delivery attempts (status, response, retries). Paginated via `?limit=` (default 25) and `?offset=` (default 0).

  • notifications_listRead-only

    List notifications for the current user. Supports cursor pagination via `?cursor=`; legacy offset pagination still works. Filters: `resource_types`, `excluded_resource_types`, `event_types`, `unread_only`; visibility toggles: `include_dismissed`, `include_snoozed`.

  • notifications_mutes_listRead-only

    List active mute rules. Pass `?include_expired=true` to also see rules whose `until` has passed (these no longer suppress notifications).

  • notifications_mute_createActs

    Create or refresh your in-app/live notification suppression rule for resourceId, eventType, or both. Matching direct mentions are suppressed there too; email and push delivery are unchanged. This does not change a chat channel's mute setting or notification preference. For ordinary channel mute/unmute use set_channel_muted. At least one selector is required; resourceId also requires resourceType. until=null or omitted means indefinite. A matching rule's expiry is refreshed.

  • notifications_mute_deleteDestructive

    Remove a mute rule by id. Scoped to the owning user.

  • notifications_mark_all_readActs

    Mark every unread notification in the optional resource/event scope as read.

  • notifications_mark_readActs

    Mark a single notification read. Returns `was_unread` — true only if THIS call flipped it. A consumer that gets `false` skips the work, so two processes on one identity cannot both act on one notification.

  • notifications_mark_unreadActs

    Convenience alias for `PATCH /api/notifications/:id` with `{read:false}`.

  • notifications_dismissActs

    Soft-delete (hide from default feed). Preserved for audit / undismiss.

  • notifications_undismissActs

    Restore a dismissed notification.

  • notifications_snoozeActs

    Hide until `{until: ISO8601}`. Pass `{until: null}` to clear snooze.

  • scan_business_cardActs

    OCR a photo of a business card and extract structured contact fields (name, title, company, email, phone, website, address, notes). Returns JSON with each field nullable when not present on the card. Use when the user uploads or references a business card image and wants to add the contact to CRM. The image must be passed as a base64 data URL (data:image/jpeg;base64,...) of an image format Gemini Vision supports (JPEG, PNG, WebP, HEIC). Max 6 MB.

  • get_unread_countsRead-only

    Get the full unread projection (mail inbox, per-channel chat badges with mute/preference resolved, notifications, total). Used for cold-connect / reconnect hydration; live updates arrive on the mux `unread` channel.

  • chat_sidebar_list_sectionsRead-only

    The caller's custom chat-sidebar sections by position, plus the order every movable section (custom, Channels, Direct) renders in.

  • chat_sidebar_place_channelActs

    Move a conversation into one of your sections. Set sectionId to null to return it to its default place. Only your sidebar changes, and other conversations stay where they are.

  • chat_sidebar_create_sectionActs

    Create a custom chat-sidebar section for the caller.

  • chat_sidebar_reorder_sectionsActs

    Reorder the caller's sidebar sections. Pass every movable section — custom ids plus "channels" and "direct" — top to bottom. Starred stays first and More last.

  • chat_sidebar_update_sectionActs

    Rename a chat-sidebar section or set its channels.

  • chat_sidebar_delete_sectionDestructive

    Delete a chat-sidebar section owned by the caller.

  • chat_drafts_listRead-only

    The caller's chat drafts (inflight + saved), newest first.

  • chat_draft_create_savedDestructive

    Create a saved draft for the caller with text, files, or both. File metadata and suggested thread placement are private references, never access grants. An optional idempotency_key retains one creation identity and binds the ordered file metadata and placement; id requires that key. Matching retries return only { id, replayed: true }, including after discard. Read the draft normally for its current content. Optional source_draft_id and source_revision atomically consume an unchanged caller-owned saved original on the first creation; a newer original stays. A missing or inaccessible source returns 404 without creating a row or receipt. Replay never checks or consumes the source again.

  • chat_draft_updateActs

    Update a draft owned by the caller. Omitted attachments or suggested_thread_parent_id preserve existing authoring state; [] removes files and null clears suggested placement. This updates the row in place; use DELETE to discard it. Optional if_revision compares the saved Read draftRevision under a row lock; stale input returns 412 without changing the row.

  • chat_draft_deleteDestructive

    Delete a draft owned by the caller. Optional if_revision compares its saved Read draftRevision atomically; a changed draft returns 412 and remains saved.

  • get_user_presenceRead-only

    Get online status (true = online within the last 5 minutes) for a set of users in the current workspace. Returns user_id → boolean. Capped at 100 user IDs. Fallback/cold-hydrate surface only — the primary presence path is the full-state push over the `presence` /ws/mux channel; poll this on connect or when the socket is down, not on a steady timer.

  • realtime_exchange_connection_capabilityActs

    Exchange JWT/ak_ for a short-lived socket capability for caller workspace/session. No inputs: credential sets identity. Object channels require resource capabilities; API rechecks writes. Principal-rate or instance DB-admission exhaustion: 429 Retry-After.

  • realtime_exchange_resource_capabilityActs

    Exchange credential for a short-lived capability on one requested object channel. REST object role decides authority; operations only narrows it. Unauthorized operations are refused, never clamped. Unreachable/absent object: 404. API rechecks writes.

  • search_paletteRead-only

    Cross-module command-palette search — every module including chat messages. `q` is the query string; `limit` caps results (default 30, max 50). Empty query returns an empty response. Module diversity is preserved. `counts` carries the per-module match total before the per-module cap.

  • search_workspaceRead-only

    Search across every module in the user's workspace (docs, sheets, slides, canvas, tasks, contacts, deals, channels, chat messages, wiki, forms, calendar, users, mail, files, teams, and saved Analytics reports for callers who can read them). Returns a flat list of results with module-aware metadata, plus `counts` — the per-module match total before the per-module cap. Optional module filter narrows the search to one or more modules; `sort` picks relevance or recency. Use this when the user asks to find something but you don't know which module it lives in.

  • get_entity_previewRead-only

    Look up a hover-card style preview of any referenced entity (document, task, contact, deal, channel, chat message, user, event, file, wiki page, form, email). Module keys include `docs`, `tasks`, `channels`, `messages`, `users`. Returns rich details — title, status, owner, due date, amount, etc. — without fetching the full record. Use this when an entity is referenced by ID and you need a quick summary.

  • list_activityRead-only

    List recent workspace activity (last 30 days). Scoped to the current user's workspace. Filterable by resource type, resource ID, and acting user. File activity uses current file view authority for data and totals. A file cohort above the activityFileCandidateMax platform limit returns 503 activity_scope_too_large; narrow by resource_id or user_id.

  • code_repository_compareRead-only

    Compare two repository refs before opening a pull request.

  • code_pull_commitRead-only

    Read the diff for one commit in this pull request.

  • code_pull_changes_since_reviewRead-only

    Compare the caller's last reviewed head with the current head. Historical or truncated source is explicitly reported.

  • code_repository_principalsRead-only

    List workspace users and teams available for an explicit repository grant. Repository owner only.

  • code_connections_listRead-only

    List repositories offered by the workspace GitHub installation. Workspace administrators only.

  • code_repositories_listRead-only

    List repositories the caller can read, with their Code role.

  • code_repository_connectActs

    Connect a repository from this workspace's existing GitHub installation. Workspace admin only; grants the connector repository ownership.

  • code_repository_updateActs

    Update the default target branch, review policy or connection. A null target resets to GitHub's default branch. Repository owner only.

  • code_repository_grantsRead-only

    Read repository access grants. Repository owner only.

  • code_repository_reviewersRead-only

    List currently eligible Ambiguous reviewers, including agents.

  • code_repository_metadataRead-only

    Read the repository labels and milestones available for pull requests.

  • code_pulls_listRead-only

    Permission-filtered pull request inbox, newest update first. Each item is a summary of what an inbox row shows; read one pull request with code_pull_get for its files, commits, description, comment bodies and activity. Pass the returned nextCursor as cursor for the next page; nextCursor is null after the last page. A page may hold fewer than limit items while nextCursor is not null.

  • code_pull_createActs

    Create/adopt a GitHub PR with accountable Ambiguous author. Base defaults to repo target; retry same idempotency key. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.

  • code_pull_getRead-only

    Read a native review, its revision, discussion, checks and merge blockers. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.

  • code_pull_refreshActs

    Reconcile with current GitHub state. Never interprets an older webhook as current source truth. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.

  • code_pull_updateDestructive

    Edit metadata, assign reviewers, follow, close, reopen or mark ready. Requires the last read version. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.

  • code_pull_reviewActs

    Submit a review for the specified comparison as an authenticated user or agent with repository review permission. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.

  • code_review_dismissActs

    Dismiss a blocking review with an auditable reason. Maintainer only. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.

  • code_review_resolveActs

    Resolve or reopen a review without changing its verdict. The PR author or maintainer may resolve another reviewer's feedback. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.

  • code_review_startActs

    Start your draft review, or return the one you already have. Add pending inline comments with create_resource_comment on the draft's id; submitting the review publishes them with its decision. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.

  • code_pull_exportRead-only

    Export the complete review record with original anchors and attribution as versioned JSON or Markdown.

  • submit_feedbackDestructive

    Describe what happened; only description required. No category or goal outcome; Ambiguous triages. Optional title, priority, context, screenshotDataUrl and attachments. Unauthenticated REST accepted; valid credentials identify reporter. Rate-limited per authenticated user or anonymous IP. Stored as a task in Ambiguous Feedback project; 200 returns task-id receipt. Storage failure 500: retry, no false receipt. Unconfigured intake 503 with {error:"Feedback reporting not available"} (raw response outside contract enum).

  • get_feedbackRead-only

    Read back one submission by its receipt. Answers only the submitter — anyone else, including other members of the submitter's workspace, gets 404. Returns the public projection: a status word (`filed` | `accepted` | `declined` | `shipped`, derived from the task Ambiguous works), the title, the priority, the task key, and timestamps. Nothing else on the task is exposed.

  • list_feedbackRead-only

    List the caller's own submissions, newest first, as public projections (see `get_feedback`). Paginated with `limit` (default 50) and `offset`.

  • agent_list_connectionsRead-only

    List every live API key acting as the caller or as an agent the caller manages, classified by how it connects: `connector` (a chat app approved through OAuth), `terminal` (a terminal tool set up from a setup message) or `api_key`. An admin or owner additionally sees every agent's keys; another member's own keys never appear. `setting_up` is true while a terminal tool has not yet redeemed its setup message.

  • agent_get_email_accessRead-only

    Read an agent's email scope, approved contacts, record version, the human who reviews its held emails, and whether the calling principal may change it. Readable by workspace humans with standing access, existing management readers, and the agent itself; `can_manage` is false for the agent's own read.

  • agent_set_email_accessDestructive

    Set an agent's email scope. A human manager or human workspace admin/owner only — an agent cannot widen its own delegation even holding the admin role, and no profile or config update can write this field.

  • list_my_teamsRead-only

    List teams the current user belongs to, with their role (admin or member) in each. Use this when the user asks 'what teams am I in?' or 'my teams' or 'my memberships'.

  • teams_searchableRead-only

    Search teams visible to the caller for the share dialog. Returns the union of public teams and private teams where the caller is a member. Supports case-insensitive name filtering via `q` and a configurable `limit`.

  • list_teamsRead-only

    List workspace teams visible to the current user. Returns public teams and private teams the user is a member of, with member counts. Filterable by `q` (case-insensitive substring match on name + slug). Optional `limit` caps the result count. Use this when the user asks to see teams, distribution lists, or workspace teams.

  • create_teamActs

    Create a new team in the workspace. The caller becomes the team admin. Teams can serve as email distribution lists (when email_local_part is set) and/or permission targets. Use this when the user asks to create a team, distribution list, or mailing list.

  • teams_members_listRead-only

    Paginated member list. Private teams visible only to members or admins.

  • add_team_memberActs

    Add a user to a team with an optional role (admin or member). Only team admins or workspace admins can add members. Default role is 'member'. Use this when the user asks to add someone to a team or distribution list.

  • teams_members_update_roleDestructive

    Change a member's role. Admin only. Cannot demote the last admin.

  • teams_members_removeDestructive

    Remove a member. Admin only. Cannot remove the last admin.

  • teams_get_subscriptionRead-only

    Get the caller's email-delivery preference for the team. Returns `{team_id, user_id, email_delivery}`.

  • teams_update_subscriptionActs

    Update the caller's email-delivery preference for the team. Body: `{email_delivery: 'each' | 'daily_digest' | 'weekly_digest' | 'none'}`. `none` is refused on the workspace-wide all-members list, which has no opt-out.

  • teams_joinActs

    Join a team. Open teams grant instant membership; request teams create a pending join request; invite teams reject.

  • teams_leaveDestructive

    Leave a team. Cannot leave if you're the last admin.

  • teams_cancel_join_requestDestructive

    Cancel your own pending join request for this team.

  • teams_requests_listRead-only

    List pending join requests. Admin only.

  • teams_requests_approveActs

    Approve a join request — adds the user as a member.

  • teams_requests_denyActs

    Deny a join request.

  • get_teamRead-only

    Get details of a single team including its first 10 members. Returns team metadata (name, slug, visibility, join policy, email) and an embedded members list with each member's user_id, display_name, email, role, and added_at. Use this when the user asks about a specific team, its members, or 'who is in team X?'.

  • update_teamActs

    Update a team's settings (name, slug, description, email, parent, visibility, join policy, posting policy, icon, color). Only team admins or workspace admins can update. If changing parent, validates no cycle in hierarchy. Use this when the user asks to rename a team, move a team under a different parent, or change team settings.

  • delete_teamDestructive

    Permanently delete a team from the workspace. Only team admins or workspace admins can delete. All memberships are removed. Child teams are orphaned (parent set to null). Use this when the user asks to delete, remove, or dissolve a team.

  • analytics_insights_createActs

    Create a saved insights report.

  • analytics_insights_updateActs

    Update a saved insights report.

  • analytics_funnels_createActs

    Create a saved funnel report.

  • analytics_funnels_updateActs

    Update a saved funnel report.

  • analytics_retentions_createActs

    Create a saved retention report.

  • analytics_retentions_updateActs

    Update a saved retention report.

  • analytics_cohorts_createActs

    Create a saved cohort definition.

  • analytics_cohorts_updateActs

    Update a saved cohort definition.

  • analytics_dashboards_createActs

    Create a new analytics dashboard.

  • analytics_dashboards_updateActs

    Update an analytics dashboard's name, dashboard query or tile layout; omitted fields are kept. Requires editor on the dashboard's project: a viewer gets 403, and a caller with no role gets 404. Every report tile must come from the same project (`400 project_mismatch`).

  • analytics_debuggerRead-only

    Unified live debugger — interleaved ingest successes and errors, cursor-paginated, tenant-isolated via writeKey ownership.

  • analytics_catalog_overrides_listRead-only

    List catalog metadata overrides for the workspace.

  • analytics_write_key_listRead-only

    List all writeKeys for the workspace (plaintext never returned on list).

  • analytics_query_executeRead-only

    Execute an ad-hoc analytics query (events/insights/funnel/retention/cohort). Returns structured results over the project's view (the workspace default project when project_id is omitted). An `events` page can hold fewer events than `limit`, or none, while `hasMore` is true; keep requesting with the returned cursor until `hasMore` is false.

  • analytics_events_listRead-only

    List source-owned Analytics evidence with bounded filters and stable pagination. Measured group IDs never grant access. A page can hold fewer events than `limit`, or none, while `hasMore` is true: a page stops after examining a bounded number of events the project view may not show. Keep requesting with the returned cursor until `hasMore` is false.

  • analytics_events_getRead-only

    Read one Analytics evidence event owned by the caller's source workspace. Foreign and missing IDs return 404.

  • analytics_insights_listRead-only

    List saved insights reports in the active workspace, including their names and query definitions. Lists one Analytics project (`project_id`) and requires a role on it.

  • analytics_funnels_listRead-only

    List saved funnel reports in the active workspace, including their names and conversion query definitions. Lists one Analytics project (`project_id`) and requires a role on it.

  • analytics_retentions_listRead-only

    List saved retention reports in the active workspace, including their names and query definitions. Lists one Analytics project (`project_id`) and requires a role on it.

  • analytics_cohorts_listRead-only

    List saved cohort reports in the active workspace, including their definitions and stored member counts. Lists one Analytics project (`project_id`) and requires a role on it.

  • analytics_dashboards_listRead-only

    List the saved analytics dashboards of one Analytics project (`project_id`), including their tile layouts. Everyone who can view the project sees every dashboard in it. Requires a role on the report's project; `404` otherwise.

  • analytics_insights_getRead-only

    Read a saved insights report's name and stored query definition by ID, without executing the query. Use analytics_insights_list to find report IDs. Requires a role on the report's project; `404` otherwise.

  • analytics_funnels_getRead-only

    Read a saved funnel report's name and stored conversion query definition by ID, without running the funnel. Use analytics_funnels_list to find report IDs. Requires a role on the report's project; `404` otherwise.

  • analytics_retentions_getRead-only

    Read a saved retention report's name and stored query definition by ID, without computing retention. Use analytics_retentions_list to find report IDs. Requires a role on the report's project; `404` otherwise.

  • analytics_cohorts_getRead-only

    Read a saved cohort's name, stored criteria and member-count snapshot by ID, without recomputing its audience. Use analytics_cohorts_list to find cohort IDs. Requires a role on the report's project; `404` otherwise.

  • analytics_dashboards_getRead-only

    Read a saved analytics dashboard's name, stored query and tile layout by ID. Requires a role on the dashboard's project; unavailable dashboards return not found. Use analytics_dashboards_list to find accessible IDs. Requires a role on the report's project; `404` otherwise.

  • analytics_settings_getRead-only

    Get the workspace's analytics settings — the timezone calendar windows such as today-7d and day/week/month buckets resolve in.

  • analytics_metric_valueRead-only

    Read one number from a saved insight or funnel over a window: the value, the same metric over the window before it, a sparkline and a link to the report. Embedded metrics on canvas, in chips and in sheets read through this. Example: report=insights:<id>&from=today-28d&to=now.

  • analytics_catalog_statsRead-only

    Per-event last_seen_at and 30-day volume for the workspace's tracked events.

  • analytics_metrics_upsertActs

    Upsert external metric rows (ad spend, cloud spend, incident minutes) keyed by metric, grain, period and dimensions. A row replaces the live value only when its observed_at is newer; an older observation is kept in the restatement history and reported as stale. Requires workspace admin rank and the analytics.write scope; the public write key is refused.

  • analytics_metric_definitions_listRead-only

    List metric definitions visible in the named Analytics project, or its workspace default when omitted. management=true instead reads the workspace-wide admin catalog. Each definition includes its newest stored period.

  • analytics_projects_listRead-only

    List the Analytics projects the caller holds a role on, each with its view and the caller's role. Workspace admins hold no implicit role: a private project an admin was not added to is not listed.

  • analytics_projects_getRead-only

    Read one Analytics project, its view and the caller's role. `404` when the caller holds no role on it.

  • analytics_projects_permissions_listRead-only

    List the project's members: users and teams with their roles. The Everyone team row is the workspace tier.

  • analytics_projects_access_request_createActs

    Ask the project's owners for access at viewer or editor. Must ask higher than the role held (`400 access_role_not_higher`); `409 access_request_open` while one is open; `404` for an unknown project.

  • analytics_projects_access_request_currentRead-only

    Return whether the caller has an open access request for the project.

  • analytics_projects_access_request_decideActs

    Approve at viewer or editor, or decline, an open access request. Project owners only. Returns 409 once decided.

  • analytics_restricted_marks_listRead-only

    List the workspace's restricted event names, trait keys and metric keys. Workspace admin only.

  • analytics_annotations_listRead-only

    List a project's annotations, oldest date first: each is a date, an optional end date, a short text and its author, drawn on every time-series chart in the project. `from`/`to` keep only annotations overlapping that range.

  • shared_with_me_listRead-only

    Everything shared with the calling account through a direct grant, a team grant, or a bound external grant, across docs / sheets / slides, Drive, Wiki, Forms and Calendar — and across every workspace and identity the account owns. Excludes what the account owns, and excludes workspace-tier access, which is standing authority rather than a share. An API key sees only resource families within its read scopes. Newest share first. `scope=workspace` narrows discovery to resources in the authenticated current workspace without changing access.

  • shared_with_me_hideDestructive

    Hide one row from the caller's own Shared-with-me list. Revokes nothing — the grant is untouched and the resource stays reachable by its id or link; only the list entry goes. 404 when the caller holds no live grant or the key lacks that resource's read scope. Idempotent.

  • shared_with_me_undo_leaveActs

    Undo a "Remove me": restore the exact grant the caller removed, from the `undo_token` the leave call returned. The token is bound to the caller, single-use, and lasts ten minutes. An outside grant is re-checked against the workspace's current outside-sharing policy. 400 `undo_token_invalid` / `undo_token_expired` / `undo_token_used`; 403 `outside_sharing_off` / `outside_sharing_domain_not_allowed`; 404 when the resource is gone or the key lacks its read scope.

  • formatter_setActs

    Set a flat map of fields on the node output. Native equivalent of the n8n `Set` node — alias `n8n-nodes-base.set → formatter_set`. Pure passthrough: `parameters.values` is resolved upstream by the dispatcher's `resolveActionParameters` walker, so JSONLogic rules referencing `{var: "<UpstreamNode>.<field>"}` produce the literal value the handler echoes back. Downstream nodes reference the result via `{var: "<NodeName>.values.<key>"}`. Spec line 41: formatters are `formatter_*` operationIds.

  • list_sign_templatesRead-only

    List reusable signing templates.

  • create_sign_templateActs

    Create a reusable signing template from field layout and signer roles. A Doc source is rendered to an independent frozen PDF snapshot. Choose either source_doc_id or source_pdf_file_id.

  • use_sign_templateActs

    Create a new draft document from a template, populating fields with placeholder signer roles.

  • create_sign_documentActs

    Create a draft signing document.

  • list_sign_documentsRead-only

    List signing documents in the workspace.

  • get_sign_documentRead-only

    Get a signing document with signers and fields.

  • get_sign_auditRead-only

    Get the append-only audit trail for a visible signing document.

  • update_sign_documentActs

    Update a draft signing document.

  • sign_add_signerActs

    Add a signer or CC recipient. An agent user can be a CC recipient but never a signer; adding one as a signer is refused.

  • sign_reorder_signersActs

    Atomically set the sequential signing order: the full ordered list of the document's signer-role ids. Draft only.

  • sign_add_fieldActs

    Add a signature field to a signing document.

  • sign_update_fieldActs

    Reassign, reposition, resize, or change requiredness for a field on a draft signing document. The field id is stable — updates never re-create the field.

  • sign_remove_fieldDestructive

    Remove a field from a signing document.

  • sign_remove_signerDestructive

    Remove a signer or CC recipient from a draft signing document.

  • sign_prepare_sendActs

    Validate signers and render the PDF preview (draft → preview_pending).

  • sign_get_certificateRead-only

    Download the Certificate of Completion for a completed document.

  • sign_verify_documentRead-only

    Verify the integrity and signature of a completed document.

  • sign_get_referencesRead-only

    List signing documents that use this document as a source.

  • set_email_archivedActs

    Archive an email or return it to the inbox. archived=true archives; false unarchives. Existing mailbox access rules apply.

  • set_mail_thread_mutedActs

    Mute or unmute a mail conversation. muted=true moves it out of the inbox and keeps future replies muted; false restores it. mailbox_id selects a shared mailbox.

  • set_mail_thread_assigneeActs

    Assign a shared-mailbox conversation to a member, or clear its assignment with user_id=null. Does not change its folder.

  • set_channel_archivedActs

    Archive or unarchive a chat channel. Archiving freezes writes for everyone. Requires the same administrative authority as the individual archive and unarchive actions.

  • set_channel_mutedActs

    Mute or unmute a chat channel for yourself, including DMs, temporarily or indefinitely. Muting silences ordinary message, keyword and subscribed-thread alerts and removes the channel-presence badge contribution; direct mentions and broadcasts still reach you. This changes the channel mute setting, not its notification preference or a delivery-suppression rule. muted=true optionally accepts until or duration_ms; omit both for indefinite mute. muted=false cannot include timing fields.

  • set_task_archivedActs

    Archive or unarchive a task. Archive is separate from Trash; archived=false does not restore a trashed task. Existing project and task permissions apply.

  • set_task_subscriptionActs

    Subscribe or unsubscribe yourself from a task's notifications. When subscribed=true, user_id may select another subscriber under the existing subscription rules; unsubscribe applies only to yourself. Subscription does not grant task access.

  • set_resource_starredActs

    Add or remove favorites (star/unstar) for documents, spreadsheets, presentations, canvases, Drive items, forms, channels, teams or Wiki pages. Resource type is resolved from ID; existing starring/access rules apply. Tasks-sidebar view/project pins use tasks_favorites_add/remove instead.

  • list_resource_commentsRead-only

    Read comments on a document, Drive file, task, wiki page, mail conversation, pull request, or code review. Resource type is resolved from ID; a mail conversation can use its thread key with mailbox_id. Every container returns the same comment model: roots with their replies, the caller's capabilities on each, and unread counts.

  • create_resource_commentActs

    Create a comment on a document, Drive file, task, wiki page, mail conversation, pull request, or code review. Replies use parent_id. anchor points at a passage, cell, slide, board point or element, Drive file region, or diff line; each container accepts only its own kinds and refuses others with 400 comment_anchor_invalid, and tasks and mail conversations take no anchor. idempotency_key makes a retry return the original comment. Mail comments are internal notes and cannot be sent as email.

  • update_resource_commentDestructive

    Update a comment by its ID. content edits the text and only its author may; expected_content checks the original text and rejects a stale edit with 409 comment_edit_conflict. resolved resolves or reopens the comment's thread, which the thread's author or anyone with edit access may do. anchor moves a root comment on a canvas board to a board point or an element, by the same rule; a reply refuses it with 400 comment_anchor_on_reply and any other container with 400 comment_anchor_invalid.

  • delete_resource_commentDestructive

    Delete a comment by its ID. Its author, or anyone with the container's moderate access, may delete it; deleting a thread's first comment deletes its replies.

  • set_reactionActs

    Add or remove your emoji reaction on a chat message or a comment. The target is resolved from ID. present=true adds; false removes. Existing parent visibility, workspace custom-emoji rules, broadcast-message identity, and missing-reaction errors apply. A comment returns the updated comment.

  • set_comment_thread_readActs

    Mark a comment thread read or unread for yourself by its root comment ID, on a document, Drive file, task, wiki page, mail conversation, pull request, or code review. read=true clears its unread badge; false keeps it flagged until reopened, even when its only comments are yours. A reply ID answers 404; marking a resolved thread unread answers 409 comment_resolved.

  • mark_resource_comments_readActs

    Mark every comment thread on a document, Drive file, task, wiki page, mail conversation, pull request, or code review read for yourself. Resource type is resolved from ID; a mail conversation can use its thread key with mailbox_id. Idempotent; read state is private.

  • list_accessRead-only

    List named/team grants, workspace/link tiers and pending invitations for a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar. id names the resource; grant IDs name recipients. To remove broad access but keep explicit collaborators and their roles, use set_visibility(visibility=restricted). The Everyone entry mirrors workspace access, not a named share. Resource kind is inferred from id.

  • grant_accessDestructive

    Granting by email sends the recipient a notification email. Share a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar with exactly one user_id or named team_id (workspace members/teams), or email (anyone). For all current/future workspace humans and agents use set_visibility(visibility=workspace, workspaceRole), not per-person grants or the Everyone entry. message applies only to email. Unsupported roles are rejected; re-sharing cannot lower a live grant.

  • update_accessDestructive

    Change an existing named user/team grant on a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar. id names the resource; exactly one user_id or team_id names the recipient. For the workspace tier use set_visibility and workspaceRole, not the Everyone entry. role and expires_at are set exactly, including shorter expiry.

  • remove_accessDestructive

    Remove a named grant, pending invitation or link access on a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar. Give exactly one user_id, team_id, pending_share_id (unaccepted invitation), or link=true (restricts the link tier; unavailable on calendars). To remove broad access while retaining explicit collaborators use set_visibility(visibility=restricted), not Everyone removal.

  • set_visibilityDestructive

    Set broad access for documents/sheets/slides/canvas/Drive/forms/wiki/calendars, not individual grants or Everyone entries. `restricted` keeps the owner and explicit collaborators and removes broad tiers; `workspace` admits current and future workspace humans and agents at workspaceRole. Result url is the product URL; never share /api/public snapshots. Unsupported fields rejected.

  • leave_resourceDestructive

    Remove your own direct grant on a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar. The owner cannot leave. Returns an undo_token that shared_with_me_undo_leave accepts for ten minutes.

  • request_accessActs

    Ask the owner of a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar, task, project, or CRM pipeline for access at a role higher than any you hold. Documents, Drive items and wiki pages offer viewer, commenter and editor; forms and calendars viewer and editor; projects commenter and editor; tasks editor; pipelines member. Returns 409 while a request is already open.

  • get_my_access_requestRead-only

    Whether you have an open access request for a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar, task, project, or CRM pipeline.

  • decide_access_requestActs

    Approve an open access request at a named role, or decline it. Only principals entitled to share the resource may decide. Returns 409 once decided.

Read from the server on 2026-11-18, including each tool's own safety annotations.

Limits

  • Consent grants everything your role allows. The only advertised scope is *; narrowing happens through your workspace role and API key scopes, not the OAuth screen.
  • Outward actions are real. Email, quotes, shares and calendar invites reach people outside the workspace.
  • Two endpoints, two catalogues. The directory endpoint omits 110 tools that /mcp serves; counts will differ by URL.
  • A catalogue this size drifts. Our live count and the directory's disagree by name in both directions.
  • Free tier has a cap. Ambiguous says teams of up to five can use the apps for free; it lists action billing and a usage dashboard for larger use.
  • Data stays in Ambiguous. Connecting does not pull in mail or files from another provider.

Sources

Use it in an agent

Put Ambiguous to work.

Connect Ambiguous once and your agents call these tools on their own: on a schedule, in a workflow, with nobody at the keyboard.

Call (650) 285-1019, Agentman.Our AI receptionist answers.