Skip to main content

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

You do not run their Mac, sync IMAP, or hold an inbox token.

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

Open in Cursor

Start here

  1. Python? → Python agent SDK
  2. Any language / understand the wire → Connect your agent
  3. 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 ask before get_excerpt.
  • Treat approval_required as 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.

Not this section

Running a node, deploying a relay, or building the phone app → For protocol developers.