well_search_mailbox_for_receipt

io.github.WellApp-ai/well-mcp · Verify this server

Search the caller's own connected Gmail, now, for one supplier's mail in a date window: the sender name or domain, from `from` to `to` inclusive, sent mail excluded. Use it for a missing receipt or invoice, one call per supplier, with the window widened by about a week on each side of the payment date because a receipt often arrives before or after the charge. It returns up to `max_results` messages, newest first, each with `from`, `subject`, `sent_at`, a short `snippet`, `already_in_well` and an `open_url` to the message in Gmail. Compare the snippet and subject against the gap's amount and date yourself: a message from the supplier is a find only when it fits that charge. `already_in_well: true` means Well's mail sync already turned that message into documents, so the receipt can be matched in Well rather than fetched. It only reads: it attaches nothing, imports nothing and contacts no one, so it needs no confirmation. `mailbox` is the address of the Gmail account searched, so an answer can name it. `status`: `searched` (the search ran; empty `matches` is a real "not in the mailbox"), `no_mailbox` (the caller has no connected Gmail in this workspace; another member's mailbox is never searched), `needs_reconnect` (the Gmail grant expired: offer to reconnect Gmail), `unavailable` (Gmail did not answer: say the mailbox could not be searched, never "not found"). When the token authorizes one workspace, call this directly — no workspace call is needed first. When it authorizes several, this read will not guess which one you mean: pass `workspace_id` on the call.