Tool reference
Tools operate on one workspace at a time. Agents typically start with list_workspaces, then get_workspace_context to learn the ids (inboxes, labels, workflow statuses, members) the other tools accept.
Read tools
Section titled “Read tools”Require the inbox:read scope. All are read-only and safe to allow unattended.
list_workspaces
Section titled “list_workspaces”Lists the workspaces the connected user belongs to. No inputs. Returns workspace ids, slugs, names, and your role.
get_workspace_context
Section titled “get_workspace_context”The ids and enum values everything else needs.
| Input | Description |
|---|---|
workspace_id |
From list_workspaces |
Returns accessible inboxes, conversation labels, workflow statuses, and workspace members.
list_conversations
Section titled “list_conversations”| Input | Description |
|---|---|
workspace_id |
Required |
inbox_id |
Limit to one inbox |
view |
open, later, or done (default open) |
workflow_status_id |
Filter by a specific status (overrides view) |
label_id, priority, placement |
Additional filters (placement: inbox, archived, trash, sent) |
limit, cursor |
Pagination — pass back next_cursor from the previous page |
search_conversations
Section titled “search_conversations”Full-text search across messages with Gmail-style operators: from:, to:, subject:, label:, inbox:, status:, is:unread, has:attachment, before:/after: (YYYY-MM-DD).
| Input | Description |
|---|---|
workspace_id |
Required |
query |
e.g. refund from:acme.com after:2026-06-01 |
offset, limit |
Pagination |
get_conversation
Section titled “get_conversation”Reads a full thread: subject, status, labels, assignees, contacts, and messages as plain text. Long threads return the most recent 30 messages. Reading via MCP does not mark the conversation as read for your team.
| Input | Description |
|---|---|
workspace_id |
Required |
conversation_id |
From list or search results |
search and fetch
Section titled “search and fetch”Aliases of search and get in the result shape ChatGPT connectors and Deep Research require. Other agents can ignore them.
Write tools
Section titled “Write tools”Require the inbox:write scope and an active workspace subscription or trial. All triage writes are reversible; none send email.
update_conversation_status
Section titled “update_conversation_status”Moves a conversation to a workflow status (workspace_id, conversation_id, workflow_status_id).
snooze_conversation
Section titled “snooze_conversation”Snoozes until a future time — the conversation moves to the Later view and returns automatically (until: ISO datetime, or null to unsnooze).
assign_conversation
Section titled “assign_conversation”Replaces the assignees (assignee_user_ids: member user ids; empty list unassigns).
set_conversation_labels
Section titled “set_conversation_labels”Replaces the labels (label_ids; empty list clears).
archive_conversation
Section titled “archive_conversation”Archives the conversation. Reversible from the Archive view.
add_internal_comment
Section titled “add_internal_comment”Adds a team-visible internal note (text, up to 10k characters). Never leaves Repliqo.
save_reply_draft
Section titled “save_reply_draft”Writes a reply draft for a teammate to review and send.
| Input | Description |
|---|---|
workspace_id, conversation_id |
Required |
body |
Plain-text reply body |
reply_all |
Include all conversation participants |
overwrite_existing |
Required to replace a draft that already has content |
Recipients and subject are derived from the conversation — an agent cannot address the draft to anyone else. If a teammate already has a draft with content on the conversation, the tool refuses unless overwrite_existing is passed.