You are here because
You ship an AI assistant (or agent framework) and want to ask a person’s mail node for answers without taking their Gmail credentials. Primary goal: connect to the network and complete a first successful tool call (usually after a phone approval).What you will build
How to integrate
The protocol is the contract. The SDK is the reference client for Python so you do not
re‑implement signing, sessions, or the offline queue.
Paste into Cursor / Claude / Codex
Copy this prompt (or open it in Cursor). The agent should pull the linked docs before writing code.Connect an agent to FAU — with docs as context
Start here
- Python? → Python agent SDK
- Any language / understand the wire → Connect your agent
- Then deepen as needed:
Mental model (one sentence)
The relay finds the user’s door; your signed tool call knocks; their phone unlocks access; their node answers from local mail.Hard rules
- Prefer structured tools and
askbeforeget_excerpt. - Treat
approval_requiredas normal control flow, not a crash. - Always show the verified agent domain and 2-digit match code to the user.
- Never request Gmail passwords or inbox OAuth for your product.