search

search.files

Search Files

Effects: read

Search files and attachments across the workspace — by content, filename, document type, or origin. For message content use search.messages; for links use search.links.

Arguments

Argument	Type	Required	Description
attachment_name	string	no	Exact filename filter. OMIT to skip (do NOT pass an empty string).
document_type	string	no	Filter by document category. OMIT unless the user explicitly mentions one — picking a value narrows the search and is a common cause of zero-result mistakes. (one of invoice, contract, presentation, report, proposal, resume, letter, manual, spreadsheet)
file_origin	string	no	File origin: 'generated' (created by tools), 'received' (from messages), 'uploaded' (manual). Use 'generated' for files the user created/sent. OMIT to include all origins. (one of generated, received, uploaded)
limit	integer	no	Maximum files to return. (default 10; min 1.0; max 50.0)
query	string	no	What to search for (content or filename).

search.links

Search Links

Effects: read

Search links/URLs shared across the workspace — by type, owner, or associated contact. For files use search.files; for message content use search.messages.

Arguments

Argument	Type	Required	Description
contact_hint	string	no	Name hint to filter links for a specific contact. OMIT to skip.
limit	integer	no	Maximum links to return. (default 10; min 1.0; max 50.0)
link_kind	string	no	Filter links by type. OMIT to include all kinds — picking a value narrows the search and is a common cause of zero-result mistakes. (one of email, calendly, twitter, telegram, linkedin, github, google_doc, google_sheet, google_slides, google_drive, google_meet, instagram, facebook, youtube, tiktok, whatsapp, vk, reddit, medium, discord, notion, figma, telegraph, luma, etherscan, website)
owner	string	no	Link owner: 'self' (user's own) or 'contact' (from others). OMIT to include links regardless of owner. (one of self, contact, unknown)
query	string	no	What to search for in shared links.

search.messages

Search Messages

Effects: read

Search message content across all chats — semantic + keyword. Use to find what was said: quotes, topics, info exchanged. For chats/threads themselves use search.threads; for files use search.files; for links use search.links.

Arguments

Argument	Type	Required	Description
date_from	string	no	ISO8601 date (YYYY-MM-DD) lower bound. OMIT to skip.
date_to	string	no	ISO8601 date (YYYY-MM-DD) upper bound. OMIT to skip.
limit	integer	no	Maximum messages to return. (default 10; min 1.0; max 50.0)
participant_name	string	no	Filter to messages involving this participant/contact name. OMIT to search across everyone (do NOT pass an empty string).
query	string	no	What to search for in message content.

search.threads

Search Threads

Effects: read

Find or list chat threads/conversations — by topic, participant, unread/unanswered status, or recency. Omit query to list threads by filter. For message content use search.messages; for files use search.files. since filters by recency and pairs with only_unread / only_unanswered.

Arguments

Argument	Type	Required	Description
include_last_messages	integer	no	With only_unanswered: inline the most recent N messages (0-2) per thread so one call is enough to draft replies. Text truncated to 150 chars; full body via messages.read_history. (min 0.0; max 2.0)
limit	integer	no	Maximum threads to return. (default 10; min 1.0; max 50.0)
offset	integer	no	Number of threads to skip (for pagination, default: 0) (min 0.0)
only_unanswered	boolean	no	Limit to threads where the last message is incoming (you haven't replied). Covers 'threads I haven't replied to'. OMIT to include answered threads too.
only_unread	boolean	no	Limit to threads with unread messages. OMIT to include read threads.
participant_name	string	no	Filter to threads with this participant/contact. OMIT to include everyone (do NOT pass an empty string).
query	string	no	Topic/keyword to search threads for. OMIT to list threads by filter.
since	string	no	ISO date (YYYY-MM-DD). Only threads with any message activity since this date (recency filter, not 'unanswered'). OMIT to skip.