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.

Task, project, document, and admin tools use independent scope pairs (task:*, project:*, document:*, admin:*). Task tools never mutate referenced Conversations.

Task read tools

Require task:read.

• get_task_context: returns shared Workflow Statuses, Task Labels, and members.
• list_tasks: paginates Tasks and supports text, inbox-reference, status, label, project ("none" matches unfiled), priority, due, completion, and archive filters.
• search_tasks: searches Task titles and descriptions.
• get_task: returns Task detail, comments, activity, followers, Conversation References, and attachment metadata.
• get_task_attachment: fetches the current attachment contents. Images and audio use native MCP content blocks; text and other files use embedded resources.
• list_tasks_for_conversation: the Tasks that reference a conversation (the conversation must be inside the connection's inbox grant).

Task write tools

Require task:write and an active workspace subscription or trial.

• create_task: creates a Task with optional description, workflow metadata, due time, project, assignees, and accessible Conversation References.
• update_task: updates versioned content and immediate-save metadata, assignees, Task Labels, and project filing (project_id, null to unfile).
• comment_on_task: adds a plain-text Task comment.
• follow_task: follows or sticky-unfollows a Task.
• archive_task: archives a Task while preserving its history and files.
• restore_task: restores an archived Task to the board.
• add_task_reference: links a conversation from the connection's inbox grant to a Task.
• remove_task_reference: removes a Conversation Reference (ids from get_task); the conversation itself is untouched.

MCP cannot upload or remove Task attachments in v1.

Project tools

Projects are shared containers that conversations and Tasks can be filed into. Reads require project:read; project mutations require project:write. Filing a conversation into a project is a conversation write and lives under inbox:write (set_conversation_project); filing a Task lives under task:write (update_task's project_id).

• list_projects: all projects, optionally including archived ones.
• get_project: one project with counts — total and completed Tasks, filed conversations.
• list_project_conversations: the conversations filed into a project, newest first, plus via_reference rows pulled in through member Tasks' Conversation References. Conversations from inboxes outside the connection's grant appear as restricted stubs with no email metadata.
• create_project / update_project: name (unique per workspace), color, description.
• archive_project: archive or unarchive (archived boolean). Archived projects are closed for filing but keep their contents.

Document tools

Documents are uploaded files in the workspace's Documents area. Reads require document:read; mutations require document:write. Both accept a scope of workspace (shared) or personal (the connected user's private documents — invisible to everyone else).

• list_documents: documents and folders with name, content type, size, folder, trash state, and an authorized download_path. Supports an active/trash view and name search. MCP cannot read file contents or upload files — uploads happen in the Repliqo app.
• rename_document, move_document: rename, or move into a folder in the document's own scope (folder_id: null for the root).
• trash_document: move to trash or restore (trashed boolean). Reversible — MCP can never permanently delete a document.
• create_document_folder, rename_document_folder, delete_document_folder: folder management. Delete only works on empty folders.

Admin tools

Require admin:read or admin:write ticked on the consent screen (requesting the scope is not enough), an owner or admin role in the workspace, and a connection that can see every inbox in it. Every admin:write change is recorded in the workspace audit log with the connected app's name. Writes also need an active subscription or trial. Billing, workspace deletion, ownership transfer, granting admin rights, and permanently deleting automations are not available.

Admin read tools (admin:read)

• list_domains: domains with verification status, the DNS records to publish, and setup steps.
• list_inbox_settings: every inbox with addresses, source (domain, Gmail, Outlook), status, mode, signature, and feature toggles.
• list_block_rules: blocked sender addresses and domains.
• list_audit_events: the workspace audit log, newest first, with an optional category filter and cursor pagination.
• list_members: members with role and inbox access (all, or the selected inbox ids).
• list_pending_invites: pending invitations with role and inbox access.
• list_automations: automations with trigger, condition, steps, status, and which steps reach outside Repliqo, plus the 50 most recent runs.
• get_automation_schema: JSON Schema for triggers, the condition tree, and every step type, plus the rules the write tools enforce.
• test_automation_condition: dry-runs a condition against recent inbound messages (or Tasks) and reports matches. Saves nothing.

Admin write tools (admin:write)

• add_domain: adds a domain and returns its DNS records. Counts against the plan's domain limit even before it's verified.
• verify_domain: checks the DNS records and marks the domain verified once they are live.
• get_domain_connect_link: a one-click DNS setup link (Domain Connect) for the user to open; the agent cannot complete it.
• remove_domain: removes a domain. Fails while any inbox still uses it.
• migrate_domain_provider: moves a domain from the legacy email provider (Resend) to the current one, keeping its inboxes and conversations. Delete the domain's root MX record first, then publish the returned records and call verify_domain. Mail on the domain pauses until they verify.
• send_domain_test_email: sends a test email from a verified domain to the connected user's own address only.
• create_inbox: creates an inbox at local_part@domain on a verified domain, shared or private.
• update_inbox: name, sender label, signature, status (disabled stops an inbox without deleting anything), tracking, sender-name personalization, auto-created Tasks, and AI recommendations (Business plan).
• delete_inbox: permanently deletes the inbox with all its conversations and attachments. confirm_inbox_name must match the inbox's exact name.
• connect_gmail_inbox, connect_outlook_inbox: return an authorization link the user opens to connect a mailbox; the inbox is created when they finish.
• create_label, update_label, delete_label: conversation labels. Deleting removes the label from every conversation.
• create_workflow_status, update_workflow_status, reorder_workflow_statuses, archive_workflow_status: board statuses. Archiving moves the status's conversations to another status first.
• create_block_rule, delete_block_rule: block or unblock a sender address or domain.
• update_workspace_defaults: the undo-send delay and the workspace default for auto-created Tasks.
• invite_member: invites an email address as a member with inbox_access_mode all or selected (+ inbox_ids). Only addresses at one of the workspace's verified domains are invited directly; for anyone else the tool sends nothing and returns a confirm_url that opens the invite form prefilled in Repliqo for you to review and send. Agents cannot invite admins.
• update_invite, cancel_invite, resend_invite: manage pending member invitations; admin invitations are app-only. Invitation emails count against the daily send quota.
• update_member_inbox_access: sets which inboxes a member sees. Admins can change members; the owner can also change admins.
• demote_admin: turns an admin into a member (owner only). There is no promote tool.
• remove_member: removes someone from the workspace. Admins can remove members; the owner can also remove admins.
• create_automation, update_automation: write a whole automation (trigger, condition, steps). update_automation replaces it and requires enabled explicitly. Automations with outbound steps (webhook, Slack, Discord, Trello, Linear, GitHub, Dropbox, email.send_reply) are saved disabled and return an enable_url for you to review.
• set_automation_enabled: turns an automation on or off. Outbound automations can only be turned on by you in Repliqo; the tool returns an enable_url instead.
• archive_automation: archives (skipping queued runs) or unarchives (back as disabled). There is no delete.

Read tools

Require the inbox:read scope. All are read-only and safe to allow unattended.

list_workspaces

Lists the workspaces the connected user belongs to. No inputs. Returns workspace ids, slugs, names, and your role. Available with any Repliqo scope.

get_workspace_context

The ids and enum values everything else needs.

Returns accessible inboxes, conversation labels, workflow statuses, and workspace members.

list_conversations

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).

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.

list_contacts

Lists contact profiles — the people your conversations are with — most recent activity first.

Returns each contact's id, email, display name, tags, conversation count, and last activity.

get_contact

One contact in depth: email, display name, tags, the shared team note, message stats (conversation and message counts, first/last seen), and recent conversations with that contact (history_limit, default 10).

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

Require the inbox:write scope and an active workspace subscription or trial. All triage writes are reversible; none of them send email — sending has its own scope.

update_conversation_status

Moves a conversation to a workflow status (workspace_id, conversation_id, workflow_status_id).

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

Replaces the assignees (assignee_user_ids: member user ids; empty list unassigns).

set_conversation_labels

Replaces the labels (label_ids; empty list clears).

set_conversation_project

Files the conversation into a project (project_id from list_projects), or unfiles it with null. Archived projects cannot be filed into.

archive_conversation

Archives the conversation. Reversible from the Archive view.

add_internal_comment

Adds a team-visible internal note (text, up to 10k characters). Never leaves Repliqo.

save_reply_draft

Writes a reply draft for a teammate to review and send.

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.

Send tools

Require the inbox:send scope — a separate permission you approve on the consent screen — plus an active workspace subscription or trial. These tools send email immediately; there is no review step. Every result echoes exactly who was emailed, and sends are rate-limited per connection. All three accept an optional idempotency_key: retrying with the same key never sends a duplicate.

send_reply

Sends a reply on an existing conversation. Recipients are derived from the conversation (reply_all to include all participants) — this tool cannot email arbitrary addresses. The inbox signature and quoted thread are appended automatically.

send_forward

Forwards a conversation to explicit recipients. The forwarded message is quoted below your note.

send_email

Starts a brand-new conversation by sending an email from one of your inboxes. The from-address is the inbox's primary address.