Overview, search, date views, message detail, threads, folders, attachments, send, reply, move, and read state.
mail.*MemoMail MCP is the authenticated bridge between AI clients and MemoOS. It now covers mailbox operations, support-case intelligence, account context, schedule data, runtime metadata, cache observability, and responsive MCP Apps UI.
Tools are grouped by intent so an AI client can discover context first, read only what it needs, and make side effects explicit.
Overview, search, date views, message detail, threads, folders, attachments, send, reply, move, and read state.
mail.*Analyze screenshots, persist vision-derived YouTube handles, verify WeThaiInvest membership, diagnose cases, and prepare reviewable replies.
support.*Expose safe MemoOS profile and connection status without leaking provider credentials, access tokens, refresh tokens, or password hashes.
account.meRead the authenticated user's MemoOS calendar events by range or local day with Google Calendar connection metadata.
schedule.list · schedule.todayLet clients inspect server version, authentication boundary, cache rules, UI support, and the current typed tool catalog.
system.metadataResponsive cards now have loading, empty, success, warning, and actionable error states plus direct tool actions where supported.
ui://memomail/v0.5.0/*Mailbox list metadata is treated differently from full message detail. This keeps provider calls bounded while preventing a cached inbox from staying stale forever.
The in-chat widgets are built for narrow host frames and mobile layouts. Long subjects, channel IDs, drafts, and tool errors wrap instead of overflowing the card.
Read tools are idempotent. Mail bodies, screenshots, URLs, and attachments are treated as untrusted external content even when returned by an authenticated tool.
system.metadata
Describe the MemoMail MCP version, capabilities, tool catalog, authentication boundary, MCP Apps UI support, and cache policy.
account.me
Read the authenticated user's safe MemoOS profile and connected-service status without returning credentials or secrets.
schedule.list
List the authenticated user's MemoOS calendar events across a date range, with optional event-type filtering.
schedule.today
List the authenticated user's MemoOS calendar events for the current local date using an explicit UTC offset.
mail.cache_status
Inspect mail-list freshness and optionally refresh stale recent metadata. Existing bodies are never re-downloaded; only newly discovered messages get bounded detail prefetch.
mail.overview
Get mailbox totals, folders, unread counts, account information, and recent messages. Stale list metadata is refreshed after 10 minutes, with detail prefetch limited to newly discovered messages.
mail.search
Search cached mailbox metadata/snippets after refreshing stale recent metadata. Existing message bodies are not re-downloaded.
mail.list_by_date
List messages received on a specific local calendar date with an explicit UTC offset.
mail.get_message
Read one message with metadata and saved MemoMail AI context; fetch full provider detail only when that message is not already cached.
mail.list_threads
List MemoMail conversation threads with status and subject filtering.
mail.get_thread
Read the conversation containing a message across mailbox folders.
mail.list_folders
List folders with message and unread counts.
mail.list_attachments
List attachment metadata for one message without downloading attachment file content.
mail.get_attachment_image
Return one screenshot/photo as native MCP image content so the AI client can inspect the actual image.
support.get_member_context
Resolve YouTube identity for a mail case, optionally accept a vision-read handle directly, persist it to the case, and verify current WeThaiInvest membership.
Write tools are annotated as side effects so AI clients can apply approval and permission policies before changing mailbox state or preparing support output.
support.prepare_case
Analyze email, thread, attachments, images, identity, and membership; prepare diagnosis and a reply draft without sending it.
mail.send
Send a new email from the connected MemoMail account.
mail.reply
Reply to a message while preserving the provider conversation thread.
mail.set_read_state
Mark a message as read or unread.
mail.move
Move a message into another mailbox folder.
Deletion is separately classified and requires confirm=true in the tool input before the provider operation can execute.
mail.delete
Delete a mailbox message. Explicit confirmation is required in the tool input.
The bearer token is validated against the MemoMail resource audience. MCP resolves that subject to an active local account, while provider credentials remain on the server.
The catalog is designed so an MCP client can choose tools from ordinary user requests.