Model Context Protocol

MemoOS context, safely exposed to AI.

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.

MemoID OAuthStateless MCPMCP Apps UIZoho MailGoogle Calendar context21 tools
Capabilities

More than a mailbox connector.

Tools are grouped by intent so an AI client can discover context first, read only what it needs, and make side effects explicit.

ML

Mail

Overview, search, date views, message detail, threads, folders, attachments, send, reply, move, and read state.

mail.*
SP

Support intelligence

Analyze screenshots, persist vision-derived YouTube handles, verify WeThaiInvest membership, diagnose cases, and prepare reviewable replies.

support.*
ID

My account

Expose safe MemoOS profile and connection status without leaking provider credentials, access tokens, refresh tokens, or password hashes.

account.me
SC

Schedule

Read the authenticated user's MemoOS calendar events by range or local day with Google Calendar connection metadata.

schedule.list · schedule.today
MD

Runtime metadata

Let clients inspect server version, authentication boundary, cache rules, UI support, and the current typed tool catalog.

system.metadata
UI

MCP Apps UI

Responsive cards now have loading, empty, success, warning, and actionable error states plus direct tool actions where supported.

ui://memomail/v0.5.0/*
Mail cache

Fresh lists without re-downloading every message.

Mailbox list metadata is treated differently from full message detail. This keeps provider calls bounded while preventing a cached inbox from staying stale forever.

01
Serve fresh cacheIf recent metadata is younger than 10 minutes, list/search reads stay in MongoDB.
02
Refresh when staleAfter 10 minutes, MCP fetches one bounded recent message-list page from Zoho.
03
Upsert metadata onlyNew IDs and changed subject/read metadata are cached. Existing full body fields are untouched.
04
Lazy detailFull body or attachment detail is fetched only when a specific uncached message is opened.
Failure behavior: stale-while-refresh. If a background list refresh fails but cached metadata exists, MCP returns the cached list with a refresh warning instead of hiding usable mail behind a provider error.
MCP Apps UI

State is visible now.

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.

LoadingSpinner + skeleton immediately, with a long-running status message instead of a blank card.
SuccessCompact data cards expose cache source, membership, integrations, schedule, and direct actions.
Empty / warningNo results and stale-refresh warnings are first-class states, not silent failures.
ErrorStructured error code, provider message, retryability, and retry-after information are rendered in the widget.
Read tools · 15

Read and understand context

Read tools are idempotent. Mail bodies, screenshots, URLs, and attachments are treated as untrusted external content even when returned by an authenticated tool.

system Read
system.metadata

MCP metadata

Describe the MemoMail MCP version, capabilities, tool catalog, authentication boundary, MCP Apps UI support, and cache policy.

account Read
account.me

My account

Read the authenticated user's safe MemoOS profile and connected-service status without returning credentials or secrets.

schedule Read
schedule.list

My schedule

List the authenticated user's MemoOS calendar events across a date range, with optional event-type filtering.

schedule Read
schedule.today

Today's schedule

List the authenticated user's MemoOS calendar events for the current local date using an explicit UTC offset.

mail Read
mail.cache_status

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 Read
mail.overview

Mailbox 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 Read
mail.search

Search mail

Search cached mailbox metadata/snippets after refreshing stale recent metadata. Existing message bodies are not re-downloaded.

mail Read
mail.list_by_date

List mail by date

List messages received on a specific local calendar date with an explicit UTC offset.

mail Read
mail.get_message

Read message

Read one message with metadata and saved MemoMail AI context; fetch full provider detail only when that message is not already cached.

mail Read
mail.list_threads

List threads

List MemoMail conversation threads with status and subject filtering.

mail Read
mail.get_thread

Read thread

Read the conversation containing a message across mailbox folders.

mail Read
mail.list_folders

List folders

List folders with message and unread counts.

mail Read
mail.list_attachments

List attachments

List attachment metadata for one message without downloading attachment file content.

mail Read
mail.get_attachment_image

Read attachment image

Return one screenshot/photo as native MCP image content so the AI client can inspect the actual image.

support Read
support.get_member_context

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.

Action tools · 5

Act with explicit intent

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 Action
support.prepare_case

Prepare support case

Analyze email, thread, attachments, images, identity, and membership; prepare diagnosis and a reply draft without sending it.

mail Action
mail.send

Send mail

Send a new email from the connected MemoMail account.

mail Action
mail.reply

Reply to mail

Reply to a message while preserving the provider conversation thread.

mail Action
mail.set_read_state

Set read state

Mark a message as read or unread.

mail Action
mail.move

Move message

Move a message into another mailbox folder.

Destructive tools · 1

Keep destructive actions unmistakable

Deletion is separately classified and requires confirm=true in the tool input before the provider operation can execute.

mail Destructive
mail.delete

Delete message

Delete a mailbox message. Explicit confirmation is required in the tool input.

Authentication & data boundary

MemoID proves identity. MemoOS keeps the secrets.

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.

MemoID OAuthRequires an access token for the MemoMail protected resource and the openid scope.
Local user bindingThe MemoID subject must map to an active MemoOS account before any tool is registered.
No reusable provider credentialsZoho and Google provider tokens are never returned from account.me or placed into MCP tool output.
Untrusted customer evidenceEmail body, OCR, images, links, and attachments remain data, never tool instructions.
Support bridge: when client vision confidently reads a YouTube handle from a screenshot, support.get_member_context can accept that handle, persist it to the MemoMail case, resolve its channel ID, and continue membership verification.
Natural client requests

Use intent, not endpoint trivia.

The catalog is designed so an MCP client can choose tools from ordinary user requests.

“What does this MCP server support and how fresh is its mail cache?”
“Show my account and which services are connected.”
“What is on my schedule today in Bangkok time?”
“List my latest mail. Refresh the list if it is old, but do not download every email body.”
“Open the newest support message, inspect screenshots, verify membership, and draft a reply.”
“Reply to this thread, then mark it read and move it to the support folder.”