Recipe · with your own agent

Your inbox, on your lens

Give your agent your mailbox and the questions you would otherwise unlock your phone for — did the invoice arrive, what did she say about Thursday, is there anything I have to answer today — get answered on the lens. Reading only, until you decide otherwise.

IRIS ProYour agent connectedGoogle Workspace MCP
Set it upAll recipes

What you get

The Google Workspace MCP server from the spreadsheet guide includes Gmail. If you set that up for Sheets, you are already one flag away from this. If not, it is the same one-time Google setup.

Seen through the glasses: asked whether anything came from the landlord, the agent answers that the inspection moved to Thursday at 10
Illustration. The answer is your agent reading your actual mail.

Set it up

  1. Agent connected
    Settings → Connections → Your agent — Hermes or OpenClaw, green chip. A plain model cannot read mail; it has no tools.
  2. Make a Google OAuth client, once
    Google Cloud Console → a project → APIs & Services → Credentials → OAuth client ID, type Desktop. Enable the Gmail API on the project. Copy the client ID and secret. This is the same step IRIS asks for when you switch on Drive exports, so you may already have one.
  3. Register the server with your agent
    For Claude Code under OpenClaw:
    export GOOGLE_OAUTH_CLIENT_ID="your-client-id"
    export GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"
    claude mcp add --transport stdio gworkspace -- uvx workspace-mcp --tools gmail
    Then /mcp inside a Claude Code session to complete the browser sign-in. Add calendar or drive to --tools if you want those too. OpenClaw needs bundleMcp: true to hand the tools through. Hermes users: its MCP section in the docs takes the same server.
  4. Tell the agent how to answer
    A short standing instruction keeps replies lens-sized:
    When I ask about my email, answer in at most two sentences: who, what, when.
    Never read a whole message back to me unless I ask for it.
    Do not send, reply, archive or delete anything unless I explicitly say so.
  5. Ask something
    Ask tab → toggle to your agent → “what came in from the school this week?”. The first answer takes a few seconds while the server fetches; after that it is quick.

Good to know

+

More recipes

Eight things IRIS can already do that most people have not switched on — four with your own agent, four with nothing but the phone.